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OVERVIEW 



INTRODUCTION 



This module presents the major features of and some key 
concepts for the DECnet Router product. The DECnet Router is one 
of a set of software products that runs on the DIGITAL 
Communications Server. These products, called Communications 
Servers, implement DECnet Phase IV and are used in Local Area 
Network (LAN) environments to provide a comprehensive networking 
service. These products allow shared costs, resources, and 
communications within both LANs and the more conventional 
Wide-area networks. The servers are connected directly to an 
Ethernet LAN and function as nodes on the network. These products 
allow nodes on and off the Ethernet to communicate: 

o With other nodes on the LAN 

o With nodes on other LANs 

o With remote terminals 

o Between an LAN and a conventional DECnet network 

o Between a DIGITAL LAN and non-DIGITAL systems or networks 



The server products perform many communications functions 
normally attributed to full-function DECnet nodes. This releases 
valuable resources from these nodes for other uses. The 
communications server products and their functions are : 

o Terminal Server - connects a cluster of terminals to the LAN. 
Each terminal has access to nodes on the network that support 
terminal servers. 

o DECnet Router Server - performs routing functions allowing 
communication between the LAN and remote DECnet nodes. 

o DECnet Router/X.25 Gateway - provides the services of the 
Router Server with protocols that conform to CCITT X.25 and 
X.29 recommendations. These protocols allow communications 
between an Ethernet node and another DIGITAL or non-DIGITAL 
system through facilities provided by a Public Packet 
Switching Network (PPSN). 



Using the communications server products, every node or 
terminal connected to the Ethernet has access to all network 
resources . 
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LAN CONCEPTS 



A LAN is a high-speed data communications network that serves 
a single building or a limited geographical area, such as an 
industrial complex, hospital, or college campus. 



Design Goals 



o High speed and bandwidth - LAN channels are designed to handle 
fast 'bursty" types of messages. This type of data usually 
originates within one office and is usually valuable only to 
people working in the same general area. 

o Reliable and maintainable components - Node and network 
interfaces, transmission media, etc. are designed so that 
failure of a component or node disables only that unit and 
does not disrupt the rest of the network. 

o Low cost - LANs allow optimal use of equipment by sharing 
resources among many users. 

o Compatibility - A large number and variety of equipment is 
able to exchange data on the network (computers, word 
processors, intelligent copiers, high speed printers, etc.) . 

o Flexible and extendable - There is minimal disruption in the 
operation of the network caused by moving devices or changing 
the shape of the network. 



In general, LANs trade distance for greater data speed, 
response time, and lowered costs. 



ETHERNET CONCEPTS 



DIGITAL uses the Ethernet LAN technology to handle high-speed 
local area communications • Ethernet provides a common path over 
which nodes can communicate or share resources. These nodes can 
be connected to the Ethernet either directly or remotely using 
communications servers. 
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Ethernet Advantages 



o Simplified network design - A simple set of design rules 
exists for an Ethernet. 

A single cable segment cannot exceed 500 meters (1640 ft) 
in length. 

- No more than 100 transceivers can be connected per cable 
segment • 

Transceivers must be installed in 2.5 meter (8 ft) 
increments (indicated by markings on the coaxial cable). 

- No more than two repeaters can be placed between any two 
nodes • 

- The maximum distance between any two nodes is 2800 meters 
(9,184 ft). 

The network cannot exceed 1023 nodes. 

Transceiver cables cannot exceed 50 meters (164 ft). 



o Simple installation - Ethernet can be brought up one node at a 
time. A new node can communicate immediately with all active- 
nodes on the network. 

o Reduced wiring - Ethernet has a single network cable that 
replaces the many interconnecting cables found in traditional 
networks. 

o Flexibility - Additional devices or cable segments can be 
added or subtracted without interfering with the rest of the 
network • 

o Reliability 

- There is no master-slave relationship or any need for 
routing nodes. (Routing nodes are highly recommended.) 

- Critical components are designed with triple redundant 
circuitry to prevent any single failure from disabling the 
entire Ethernet network. 



o High speed 

Ethernet provides a 10-Mbps signaling rate. 

- The maximum attainable rate between systems is 1-Mbps. 

- The limiting factor is the DEUNA. 



o Interconnection with other vendors' equipment - It is possible 
to connect to other vendors' equipment at the data link level 
or through X.25 Gateways. 
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Ethernet Nodes 



o Host Node - a full function DECnet Phase IV node. 

o Loading Host - a host used to down-line load the server 
software across the Ethernet. 

o Maintenance Host - a node with event logging enabled to accept 
events from a server node. The maintenance host is also the 
node that down-line loads or accepts up-line dumps for the 
server node. 

NOTE 

The maintenance host is usually the host that 
initially loads the server. If the server 
should be reloaded by another host, the new 
loading host normally becomes the maintenance 
host. One node may be set up to be the 
maintenance host if all the Ethernet hosts 
recognize it in their database. 



o Backup Host - alternative hosts set up to serve as maintenance 
hosts whenever the initial maintenance host is not available. 

o Routing Node - a node that keeps an updated database on the 
state of the other nodes in the network. Depending on the 
network configuration, these nodes are not restricted to the 
local Ethernet. 

o Designated Router - the router with the highest priority. End 
nodes depend on the Designated Router to help route messages 
to a destination. 

o End Node - a node that keeps addresses of some Ethernet nodes 
in "cache", does not know anything about the state of the 
other nodes in the network. End nodes use the Designated 
Router, if the Ethernet has one, to get to other Ethernet 
nodes or to nodes outside of the Ethernet. 
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Ethernet Addressing 



A node on the Ethernet can address either a specific node or 
a group of nodes within the same Ethernet environment. Addressing 
a group of nodes involves the use of a multicast address. The 
message is sent, simultaneously in one transmission, to a specific 
group of nodes identified by the multicast address. Addressing a 
single Ethernet node is done by using either the Ethernet Hardware 
Address or the Extended-DECnet Node Address. The Ethernet address 
types are: 



o Ethernet hardware address - a unique address that is 
permanently associated (in ROM) with each DEUNA controller on 
the Ethernet. It is made up of 12 hexadecimal digits, 
represented in six pairs separated by hyphens. This address 
is displayed by the server hardware during the system loading 
procedure. 

' AA-00-03-00-01-23 



o Extended-DECnet node address - this address is built by the 
DEUNA controller software when DECnet is loaded into the 
Ethernet node. It is made up of an 8 hexadecimal digit 
constant that has been assigned to DIGITAL, with the node's 
DECnet address appended to it. 

AA-00-04-00 (constant) 

04-3B (DECnet node address) 

AA-00-04-00-3B-04 ( extended-DECne t node address) 



o Ethernet physical address - the address that the DEUNA is 
currently responding to. Initially this is the Hardware 
Address. Once DECnet is loaded, the Physical Address becomes 
the Extended-DECnet Node Address. The Hardware Address is not 
used again unless, the node is powered down. 



o Multicast address - a mult idestination address of one or more 
nodes on a given Ethernet. Used to simultaneously address: 
- All Ethernet routers 
Backup hosts 
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Ethernet Layers 



The Ethernet specification defines the two lowest layers of 
the DNA, the Data Link and Physical layers. The rest of the DNA 
or the layers above Data Link are defined as the Client Layer. 
The Client Layer is responsible for: 

o Error recovery 

o Flow control 

o Internet communications 




INTERFACE 



DATA LINK LAYER 

: — r~ 

INTERFACE 

__i 

PHYSICAL LAYER 
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Figure 1 Ethernet Architectural Layering 
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Data Link Layer 



The Data Link Layer defines a medium-independent link level 
communications facility. 

o CSMA/CD - Implements Carrier Sense Multiple Access with 
Collision Detection channel access. 

- There are no transmissions if another host is transmitting 
(check for carrier signal — carrier sense). 

All nodes have an equal opportunity to use the channel 
(multiple access). 

- When transmitting, check whether other stations are 
transmitting at the same time (collision detect). 

- If a collision occurs, retransmit after a random period of 
time • 



o Data encapsulation - like all Data Link Layers, it is 
responsible for: 

- Framing (frame boundaries) 

- Addressing (source and destination) 

- Error detection (physical channel errors only) 



o Link management 

- Channel allocation 

- Contention resolution (collision handling) 



Physical Layer 



o Provides a 10-Mbps physical channel through a coaxial cable 

o Insulates the Data Link Layer from the physical aspects of the 
cable 

o Specifies physical characteristics of the Ethernet 
- Data encoding 
Timing 

Voltage levels 
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Figure 2 Data Flow from Node 1 to Node 3 
(Ethernet Portion of the Network) 
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Figure 3 Ethernet Data Link Layer Frame Format 



Destination address field - specifies the station(s) for which 
the frame is intended. It may be a physical or multicast 
address • 

Source address field - specifies the station sending the 
frame. The source address field is not interpreted by the 
Data Link Layer. It is specified here for uniformity and 
because this field is necessary to higher level protocols. 

Type field - reserved for use by higher layers. It identifies 
the client layer protocol associated with this frame. The 
type field is not interpreted by the Data Link Layer. 

Data field - contains data from the Client Layer. This data 
includes higher level protocols as well as user-defined data. 
This field provides full transparency to the Client Layer. 

Frame check sequence field - 32-bit Cyclic Redundancy Check 
(CRC) . 
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Ethernet Communications 



Transmission Without Contention 



o Client Layer requests the transmission of a frame. 

o Data Link Layer builds the frame from the client-supplied data 
and appends a frame check for error detection. 

- Attempts to avoid contention with other traffic by 
monitoring the carrier sense signal. 

- When the channel is clear, the frame is passed to the 
Physical Layer for transmision. 

- Once transmission is complete, the Data Link layer informs 
the Client Layer and waits for the next frame to transmit. 



Reception Without Contention 



o The arrival of a frame is detected by the Physical Layer, 
o The frame is decoded and passed up to the Data Link Layer, 
o The Data Link Layer checks the CRC for error. 

o The Data Link Layer checks the destination address to 
determine if the frame belongs to this node. If so, the data 
is passed on to the Client Layer. 
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Contention Handling 



If more than one Ethernet node attempts to transmit at the 
same, time the result is a collision. If a collision occurs: 

o The Physical Layer detects the collision and turns on the 
Collision Detect signal. 

o The signal is detected by the Data Link Layer and collision 
handling begins : 

Data Link Layer transmits a "jam" signal so that the nodes 
Involved realize that a collision has occurred. 

- A retransmission attempt is scheduled after a randomly 
determined period of time. 

- Retransmissions are repeated in the event of repeated 
collisions • 



NOTE 

In the event of repeated collisions Link 
Management services will adjust to the channel 
load by voluntarily delaying retransmissions 
(backing off) to reduce the load on the 
channel. The Data Link Layer will attempt 15 
retransmissions before dropping the message. 
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Ethernet Routing 



The routing layer for Ethernet nodes is handled differently 
from routing on DECnet nodes. There are: 

o Ethernet Router Hello messages 

o Ethernet End Node Hello messages 

o Ethernet Routing message 

o No initialization or verification messages 



Ethernet Routing Layer Handshaking 



Phase IV Nonrouting Node (Node A) Coming up on the Ethernet 



o Node A multlcasts an "End Node Hello Message" to all routers 
on the Ethernet. This message is repeated periodically to 
prevent corruption of the routing database due to messages 
that are lost. 

o The Routers update their databases to include the new node 
(Node A). The routers multicast "Router Hello Messages" 
periodically to all other routers. The Designated Router (the 
router with the highest router priority) multlcasts the 
"Router Hello Message" to all nonrouting nodes. 

o The nonrouting nodes store the information about the 
Designated Router. 

o When Node A wants to communicate with Node B, it does the 
following : 

- Check if the information about Node B is already in its 
"cache". If so, Node A will address Node B directly. 

- If no information is in "cache", Node A addresses the 
designated router to route the message to Node B. 

- If there is no designated router, Node A addresses Node B 
directly . 
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Figure 



4 Ethernet End Node 
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OVERVIEW 



Phase IV Routing Node (Node A) Coming up on the Ethernet 



o Node A multicasts the Router Hello message to all Routers* 

o The Routers update their database to include Node A as a 
routing node. 

o The Routers determine who will be the Designated Router by a 
"Router Priority" field in the Router Hello message. The 
Router with the highest priority is the designated router. If 
two routers have the same priority, the one with the highest 
node address becomes the Designated Router. 

o End nodes notify Node A that they exist by sending "End Node 
Hello" messages. 

o Due to resource constraints, there is a practical limit of ten 
routers on any one Ethernet network. 
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Figure 5 Ethernet Routing Node Communication 
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DECSA HARDWARE 



The DIGITAL Ethernet Communications Server (DECSA) Is an 
Ethernet based system for local area networks. There are three 
basic versions of the server each supporting one of the following: 

o 8 lines for connections to another Ethernet, DECnet, or a PPSN 

o 16 lines for terminals 

o 32 lines for terminals 



The server hardware consists of: 



o PDP-11 Processor - The processor along with the operational 

software, which resides in memory, controls all of the server 

operations. This software is down-line loaded over the 
Ethernet. 



o Memory Module ( 512KB ) 



o Ethernet to Unibus Adapter (DEUNA) - uses DMA to transfer 
messages between memory and the Ethernet. 

o Console/Boot/ Terminator (CBT) - provides all the console 
functions and indicators. 



o Protocol Assist Modules (PAM) - uses DMA to transfer messages 
between memory and line cards. Implements the DDCMP protocol, 
frames HDLC messages, and provides a forms control 
asynchronous protocol for terminals. 

o Line Card 8 - contain the logic to Interface between the server 
and the physical line. The line cards support different line 
speeds and protocol types ( DDCMP, HDLC, Asynchronous for 
terminals ) • Table 1 shows the various line cards available 
for the server products. Figure 6 shows the components of a 
communications server hardware unit. 



18 



OVERVIEW 



Table 1 Communications Server Line Cards 



LINE CARD 
M3100 



M3101 



M3102 



FEATURES 

- One synchronous line 

- Up to 19.2 K bps 

- Full Duplex 

- RS-233-C/V.24 

- One synchronous line 

- Up to 500 K bps 

- Full Duplex 

- V.35 

- Two-line asynchronous 

- Up to 19. 2K bps 

- Full Duplex 

- RS-232-C/V.24 



SERVER TYPE 
DECnet Router 

DECnet Router/X.25 Gateway 
Terminal Server 



DECnet Router 

DECnet Router/X.25 Gateway 



- Terminal Server 
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Figure 6 Communications Server Hardware Components 
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SERVER SOFTWARE 



The server software is logically divided into two sections: 

o Server base - an RSX 11-S operating system that provides 
generic DECnet communications capabilities and is common to 
all server products. 

o Server specific software - implements a particular server 
function using the facilities provided by the Server base. 



The Server base itself is not a product; specific software must be 
layered on top of it. The type of software layered determines the 
server's function (Terminal server, DECnet Router, etc.). The 
server-specific software and Server base form a product that is 
packaged as a single image on the distribution media. This image 
is copied to an Ethernet host and down-line loaded into the server 
hardware • 



DECnet Router Server 



The DECnet Router Server offloads routing tasks from the 
Ethernet hosts that it serves. This allows the host systems to 
function as end nodes in the network, thus freeing processor time 
for applications. The host systems can also share the use of all 
the Router Server's communications lines. The DECnet Router 
server supports: 

o Up to eight synchronous point-to-point lines 

o Routing to 1022 nodes on either local or remote networks 

o Communications to all nodes on the Ethernet network 

o Connection to another Ethernet network 



Table 2 shows the maximum line configurations supported by 
the DECnet Router Server. 
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Table 2 DECnet Router Maximum Line Configurations 



Max Line Speed 



M3100 



M3101 



19.2 Kb 



8 



56 Kb 



8 



256 Kb 



2 



500 Kb 



1 



NOTE 



The maximum line speed for the Router Server is 
500 Kbps. 



The' remote nodes connected to the Router server may be any one of 
the following: 

o DECnet router servers or Phase IV DECnet routing nodes on 
other LANs. 

o Phase III or Phase IV DECnet routing nodes in a wide-area 
network 

o Remote Phase III or Phase IV nonroutlng nodes (end nodes) 

Figure 7 shows a DECnet Router Server, RTRDEV, with three 
synchronous lines connected to other DECnet Phase IV and Phase III 
routing and end nodes. 
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OVERVIEW 



DECnet Router Server Features 



FEATURE 



BENEFIT 



Dedicated Phase IV 
adaptive routing 



Phase III compatibility 



Support for up to 8 
synchronous lines 



Shared expense for all users of 
leased lines 

Routing overhead is offloaded 
from host systems 

Greater network reliability 

Network configuration flexibility 

LAN to LAN interconnection 

Investment protection for existing 
Phase III networks 

Direct access to many local or 
remote nodes 

Up to 500K bps for 1 line 
Cost effective connections 
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Figure 8 Ethernet Configuration Utilizing a Router Server 



INSTALLATION AND CHECKOUT PROCEDURES 



Installation consists of copying files from distribution 
media to each of the hosts that will be used to load the server. 
It requires the user to: 

o Create an account and related directory with an ID (PLUTO) and 
a password (PLUTO) 

o Edit configuration files to customize the server to his needs 

o Set up the Down-Line load database 

o Use an automated installation procedure (VMSINSTAL or 
RSXINSTAL) 
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Configuration Files 



Sample configuration files are supplied as part of the 

distribution kit. There are two such files for each server 
product : 

o Network configuration file - contains network-related 

information to be used by the server. 

o Software Configuration File - contains server product-specific 
information 



These configuration files contain default parameters initially and 
can be edited by the user to reflect his network needs. 



Down-Line Loading on the Ethernet 



Once the distribution image is copied, the down-line load 
database set up, and the configuration files edited, the system 
image is down-line loaded into the server hardware unit. The 
down-line load includes: 

o The 11-S system image 

o DECnet capabilities 

o Configuration determined by the configuration files 



Down-Line Loading 



o NCP>LOAD NODE or TRIGGER command initiates the load, 
o Uses MOP protocol. 

o The server node transmits a REQUEST PROGRAM message to the 
loading host or to the "LOAD ASSISTANCE" multicast address for 
backup hosts • 

o The host that responds sends the secondary bootstrap code, 
o The loading sequence continues with the tertiary loader, 
o Finally, the operating system image is sent. 
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Up-Line Dumping 



If the server node should crash, then an up-line dump will 
occur to the host or hosts specified in the down-line load/up-llne 
dump database. 



o Uses MOP protocol. 



o The server attempts to dump its' memory to the host which 
initially loaded it. 

o If that host in unavailable, the server will search its' 
backup host list for another host to receive the dump. 

o If no hosts are available, the server will use the multicast 
address. The first host that responds will be used. There Is 
no way to determine which host received the dump other than to 
check each host's event log for event 0.3. 
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Figure 9 Down-Line Loading the System Image 



OVERVIEW 



NODE TROUBLESHOOTING 

There are a number of basic tools available for managing the 
server node. These include the standard NCP functions which allow 
a user to: 

o Configure a node 

o Configure the network 

o Test nodes and the network 

o Control node and network operations 

o Inspect and monitor a node or network 

Along with the NCP capabilities provided for troubleshooting there 
several tools available for diagnosing more complicated node and 
network problems. 

o Diagnostic tools 

Server Self Test 

Loadable Diagnostic Image (LDI) 

o Network management facilities 

- Loopback Tests 

- Error Counters 

- Network Event Logging 
Remote Console Facility 

o On-line Debugging Tool 
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INTRODUCTION 



Installation of a communication server software product 
Involves choosing a host node directly connected to the Ethernet 
which will serve as the loading host* This loading host can he 
any Phase IV DECnet RSX-1 1M/M-PLUS or VAX/ VMS node. Additional 
host nodes may be chosen to serve as backup hosts in the event 
that the initial or "primary" host is not available. Backup hosts 
can be used to load the server software as long as the particular 
software configuration files have been copied to these nodes and a 
down-line load database on each has been set up* 



NOTE 



RSX hosts must support multiuser protection* 



• The procedure for installing the server software products is 
automated* Briefly, it performs the following functions: 

o Creates an account and directory on the loading host* The 
installation command file prompts for needed information* 

o Copies all files from the distribution medium into the newly 
created directory on the host* 

o Sets up the down-line load and up-line dump database on the 
Initial loading host system* 

o Copies loader files and system images to SYS$SYSTEM on VMS 
hosts and to NETUIC on RSX hosts* 

o Sets up the server software configuration file* 



Once the software has been Installed the remaining steps are 
performed manually: 

1* Load the server software into the communications server* 



2. Perform the installation checkout procedures to verify that 
the server product is working properly* 

3. Copy files to any backup host(s) that have been selected. 

4. Protect directories, accounts, and configuration files 
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This nodule covers the preparation, installation, and loading 
of the DECnet Router server software. 



REFERENCES 

DECnet Router Server Installation and Operation Manual 
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PREPARING TO INSTALL THE SERVER SOFTWARE 



Prior to installing the server software several preliminary 
steps must be taken: 

o The communications server hardware must be installed; the 
hardware self tests and diagnostics must be completed without 
error. 

o The user needs to: 

- Know the DEUNA 48-bit Ethernet hardware address* This 
address uniquely identifies the communications server 
hardware unit and is displayed during the hardware long 
self test. 

- Know the line card configuration (recorded on the Line 
Configuration Worksheet before installation). 

Know modem and network characteristics such as modem 
speed, network buffer size, maximum address, etc* 

Enable event logging at the server's loading host console 
or monitor* 

Copy sample configuration files and make necessary changes 

to it. 



NOTE 

The Ethernet hardware address should be recorded 
on the back of the front cover and on the Line 
Configuration Worksheet provided with the hardware 
installation guide. 
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INSTALLING THE SERVER SOFTWARE 



Installing the server software is an automated procedure: 
for a VMS host the procedure is accomplished through the use of 
the VMSINSTAL command file in SYS$UPDATE. Installing the software 
on an RSX host is done by executing the RSXINSTAL command file 
after copying the distribution to any UIC on the loading host* 
These automated procedures require very little from the user other 
than answering questions as they appear while the command file 
runs* Most questions require either (Y)ea or (N)o answers* 



Installing the Server Software on a VMS Host 



To begin the installation session on VMS, the user must first 
log into the SYSTEM account, and enter the following command: 

# 

$@SYS$UPDATE : VMSINSTAL CSVRTR device name 

device name - device on which the distribution kit is 
mounted 

NOTE 

The VAX- 11 Software Installation Guide provides a 
full description of the VMSINSTAL procedure* 

Example 1 shows a Router Server Installation session on a VMS 
hos t • 
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Example 1 VMS Installation Procedures 



$ SET DEF SYS$UPDATE 
$ @VMSINSTAL 



VAX/VMS Software Product Installation Procedure 



It is 9-JAN-1984 at 09:34 

Enter a question mark (?) at any time for help 

ZVMSINSTAL-W-DECNET, Your DECnet network Is up and running* 
ZVMSINSTAL-W-ACTIVE , The following processes are still active: 

HARROLD 

JONES 

MARSHAL 

ERICKSON 

WALDEN 

* Do you want to continue anyway [NOJ? Y" 

* Are you satisfied with the backup of your system disk [YES]? Y 

* Where will the distribution volumes be mounted: MTAO: 

Enter the products to be processed from the first distribution volume set. 

* Products: CSVRTR 

The following products will be processed: 
CSVRTR VI. 



Beginning Installation of CSVRTR VI. at 09:35 
%VMSINSTAL-I-RESTORE, Restoring product saveset A... 
Router Server VI. Installation procedures. 

The following set of questions asks you for Information used to 
set up the account which will be used to Install the Router 
Server software. 

* Device for the account [ SYS$SYSR00T : J : 

* UIC for account [014,001]: 

If there is already an account named PLUTO, you will receive a 
warning message which you may ignore. 
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%VMSINSTAL-I-ACCOUNT, This installation creates an account named PLUTO. 

user record successfully added 

ZXZZXZXXZXX OPCOM 9-JAN-1984 09:37:36.90 

Message from user SYSTEM 

PID-00003056 SYSTEM added SYSUAF record PLUTO, on 9-JAN-1984 09:37:36:86 

ZVMSINSTAL-I-SYSDIR, This product creates system directory [PLUTO]. 

Installing Router Server VI. files. 

Router Server VI. files installed. 

The images and command files of Router Server 

VI .0 have been restored to disk. The next step in the 

installation is to run RTRNCP.COM. 



Executing command file RTRNCP.COM. 



This command procedure defines the database on your VMS host 
which allows you to downline load the server software and 
to receive an upline dump of the server software after a 
crash • 

This command procedure can be run for any number of Router 
Servers. Each execution produces an NCP command file unique for 
each given Router Server. 

This procedure can optionally execute the NCP command file. 



Server node-id 
Server node number 
Hardware address 
Maintenance host 
Service circuit 
Service password 
Store file 
File name 
Storage device 
Storage directory 



(1-6 chars) 

(1-1023) 

(12 hex-digits) 

(1-6 chars) 

( ) 

(1-8 hex digits) 
(YES or NO) 
(1-12 chars) 
( ) 
( ) 



[ 1 
U 
[ ] 

[EXODUS] 
[UNA-0] 
[0] 
[YES] 

[DEAG0L.COM] 
[SYS$SYSR00T: ] 
[PLUTO] 



DEA60L 
125 

AA-00-03-01-09-63 



Creating file SYS$SYSR00T: [PLUTO] DEAG0L.COM 

* Execute file (YES or NO) [NO] : Y 

%NCP-I-NMLRSP, listener response - Success 
Remote node - 125 (DEAG0L) 
Database entry deleted 

XNCP-I-NMLRSP, listener response - Unrecognized component, Node 



Executing procedure RTRSB.COM 

This procedure creates the DECnet Router Server 
network configuration file. 
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The network configuration file will be named 
' serve r_ node_id 'SB. CFG 

where 'server_node_id ' is the node name you have assigned 
to the DECnet Router Server. 



* Service password 

* System password 

* Clock frequency 



* Router Server Node 



(1-6 chars) [DEA60L] 

(1-8 hex digits) [0] 

(1-6 chars) [null] 

(50 or 60) [60] 



The next set of questions asks for backup hosts. 

You may enter a maximum of five (5) backup hosts. 

A null entry or five (5) entries will terminate solicitation 



* Backup host 



(1-6 chars) 



[null] 



Created the configuration file SYS$SYSR00T : [PLUTO] DEAGOLSB .CFG 

During the first step of the DECnet Router Server installation, 

a predefined Router configuration file was copied 

to the newly created directory (PLUTO PLUTO) On the loading 

host. (Appendix B of your DECnet Router Server Installation and 

Operation Guide shows the predefined files used for a 

DECnet Router Server.) If you are 

using that configuration file as it is, then you have 
finished Installing your Router Server. If you wish to 
customize that file or create your own, then read Chapter 3 
of the installation manual. 

* more Servers to define [NO]? N 

ZVMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories. 



Enter the products to be processed from the next distribution volume set. 
* Products: EXIT 



Successful installation of CSVRTR VI. at 10:16 



VMSINSTAL procedure done at 10:17 



$ 
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Installing the Server Software on an RSX-1 1M/M-PLUS Host 



The server distribution kit for an RSX host includes a copy 
of the server software image, configuration files, and other 
software* First the user must copy the distribution kit onto any 
UIC on the loading host. Then the RSXINSTAL command file may be 
run. This command file prompts for the main parameters needed to 
install the DECnet Router server. RSXINSTAL provides the 
following : 

o Sets up a special account on the host for storage of the 
server configuration and command files (PLUTO/PLUTO). 

o Moves other files to their respective locations 

o Sets up the Network Configuration file. 

o Prompts for parameters to be used to down-line load or receive 
an up-line dump. 



NOTE 

The PLUTO/PLUTO account should be set up so users 
cannot log into it. Appendix F in the Router 
Server Installation and Operation Guide provides 
information on protecting the PLUTO accounts and 
files. 



Copying the Distribution Kit 



The procedure for copying the distibution kit depends on 
whether the kit is a tape or RL02 disk. 

Copying a tape distribution requires the user to: 

1. Set UIC to the account set up for the Installation [x,y] 

2. Allocate and Mount the tape drive 

3. Use the BRU utility to copy the distribution files 

Once the BRU utility is finished copying the files a message will 
be displayed on the user's terminal. The distribution files are 
now in the [x,y] account on the host. The .SYS files should now 
be moved to the network UIC and the configuration files moved to 
the PLUTO account. 
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Copying a disk distribution kit: 

1. Copy the .SYS files to the network UIC 

ASN LB:-SY: 

SET /UIC«[netuic] 

PIP /NV-DLn: [x,yJ*.SYS 



2. Copy the configuration and command files to the PLUTO account 

SET /UIC-[uic] (PLUTO account) 
PIP serve r-node-idSB. CFG/NV-DLn : SB. CFG 
PIP serve r-node-idRTR. CFG/ NV«DLn : RTR.CFG 
PIP /NV-DLn: CSVRTRICP.CMD 



Example 2 shows a Router Server installation session on an RSX 
host • 



Example 2 RSX Installation Procedures 



OECnet Router Server Installation Procedure 
Started at 13:08:34 on 03 -FEB- 8 4 



Copyright (C) 1984 by 

Digital Equipment Corporation, Maynard, Mass. 

This installation procedure installs the OECnet Router Server (server) 
on a RSX-11M/M+ host. This procedure must be run from a privileged 
account . 

This procedure will create and copy server files. It will create a 
network configuration file based on the answers supplied in secton 2. 
A file named CFE<node> • CMD will contain the CFE commands to define the 
permanent database on this host. You have the option of not moving the 
OECnet Router Server system files. This allows you to simply use the 
command procedure to set up a second OECnet Router Server. 



In other words , when you are setting up more than one 

DECnet Router Server, you do not need duplicates of the 

software images and loader files. The same image and 
loader files can be used for each server. 

; You may type an escape <ESC> at any question to obtain additional 
; information about the question. 

; <EOS> Do you want to: 

* <RET>-Continue, E-Exit [S]: 
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Section I - General information 



Nov you must decide where you would like to put the various DECnet 
Router Server files. It is suggested that you pick one uic for the 
configuration files, one uic for the loaders and system images and one 
uic for the dump images. 

NOTE: The uic where the configuration files reside must have a user id 
and password of PLUTO/PLUTO. 

When answering questions in this section please type the full 
directory specification. ( DEV: [ nnn , nnn ] ) 

The last question of this section gives you the option of 
running the ACNT program to add new directories. 



>* 1.00 Where will the configuration files reside (S D: - SY: [40,40]"-] : 

This is the uic that is set up as the PLUTO/PLUTO account on the 
host. Your <server-node-id>SB.CFG and <server-node-id>RTR.CFG 
configuration files must reside in this uic. These tilem are 
read by the DECnet Router Server's initialization tasks from 
this account. Enter the uic specification in the form: 



>; 
>• 



>; 
>; 
> 



DEV: [nnn, nnn] 



>* 1.00 Where will the configuration files reside [S D:"SY: [40,40]*] : 
>* 1.01 Where will the system files reside [S D:"dev: [ nnn,nnn ] j: 
>• 

>; The system files can reside on any uic on the host system. A 
>• separate uic is a neat and convenient method of partitioning host 
>; software from server software. Enter the uic specification in the 
>; form: 



DEV: [nnn, nnn] 



> . 

>* 1.01 Where will the system files reside [S D:"dev: [43 ,43]" ].: 
>* 1.02 Where will the dump files reside [S D:"dev«T43,43]"]: 
>• 

>; The dump files can reside on any uic on the host system. A 
>; separate uic is a convenient method of insuring disk storage for 
>; a dump image. Enter the uic specification in the form: 



DEV: [nnn, nnn] 

>* 1.02 Where will the dump files reside [S D:"dev: [43,43]"] : 
>* 1.03 Do you need to run the account program to add these directories? LY/. 
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The uic specification you supplied may not exist on your disk. You 
can elect to run the accounting program now and add the nev uic's 
to the system. Remember you must also create a PLUTO/PLUTO account 
for the configuration files. 



If- you answer YES, RSXINSTAL runs the account file 

maintenance program (ACNT) so that you can add 

directories. Section 2.3.4 explains how to respond to. the 
ACNT program. 

* 1.03 Do you need to run the account program to add these directories? [Y/N 

* <EOS> Do you want to: 

* <RET>-Continue, R-Repeat section, E-Exit [S3; 



>; Section 2 - Building the network configuration file 

>• ■»»»»»«••••»»»»««•«»»»»»»»»»»■»»»•»*»»•»•»»■»»■«••■»»«»»■»»«■»•»»•»»» 

>• 

This file contains LAN software network parameters used by 
the DECnet Router Server. Chapter 3 describes the 
parameters in detail and explains how to edit the 
configuration file to change the parameters. Appendix B 
contains a sample network configuration file. 

>* 2.00 What is the node- id of the server [S]: 
>• 

>; Every DECnet node can be identified by a unique name. You should 
>; choose a unique name for each node in the network. A node name is 
>; one to six alphanumeric characters. At least one character must be 
>; a letter. 
>• 

>* 2.00 What is the node- id of the server [S]: 

>* 2.01 What is the node-address of the server [D R:l.-1023.]: 

>; 

>; Every DECnet node can be identified by a unique number. You 

>; should pick a unique number for the DECnet Router Server. 

>; 

>* 2.01 What is the node-address of the server [D R: 1.-1023.]: 

>* 2.02 What is the UNA-0 password for the server [S R:l.-16. D:"0"]: 

>; 

>; The UNA-0 password (service password) is used to prevent 
>; unauthorized users from triggering or loading the DECnet Router 
>; Server. The password is one to sixteen hexadecimal characters. 
>; 

>* 2.02 What is the UNA-0 password for the server [S R:l.-16. D:"0"]: 

>* 2.03 What is the network privileged password for the server [S R:0.-8.]: 

>; 

>; The network privileged password is supplied on network management 
>; commands. This is to prevent unauthorized users from issuing 
>; privileged commands to the DECnet Router Server. 
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>; 

>* 2.03 What is the network privileged password for the server [S R:0.-8.]: 
>* 2.04 What is the system line clock frequency for the server [D R:50.-60. D 
>; 

>; The clock frequency used in the United States is 60 Hz and in 
>; Europe is 50 Hz. 
> • 

>* 2.04 What is the system line clock frequency for the server [D R: 50.-60. O 
>; 

>; If you want more than one backup host enter them separated by commas. 
>; i.e. HOSTl,KOST2,HOST3 

>; 

>* 2.05 What are the node-id's of the backup hosts [S]: 
>: 

Backup hosts are needed when the server's maintenance host is out 
of service. A DECnet Router Server may need to log an event or 
upline dump a system image. If the maintenance host is down, a 
backup host is needed to assist the DECnet Router Server. Be sure 
to set up the server databases on the backup hosts. Enter the 
backup hosts as a list. The maximum is five backup hosts. For 
example: 



HOST1 , HOST2 , HOST3 , KOST4 , HOST.5 
>* 2.05 What are the node-id's of the backup hosts [S]: 



>? Building the network configuration file. ( dev ; C nnn , nnn ] server-node- idS B . CPS' 
>; 
>; 

>; NOTE: You must also tailor the router configuration file in 

>; dev : [ nnn , nnn ] server-node- idR TR. CFG after this procedure completes. 

>? 

The router configuration file contains parameters for the 
routing database used by the DECnet Router Server. The 
file supplied with the distribution kit se.ts up default 
parameters for 8 point-to-point lines and the UNA. 
Appendix B shows this file. You can use the file as is, 
provided your configuration matches the defaults defined 
in the file. You can edit the file to tailor it to the 
needs and characteristics of your network, as explained in 
Chapter 3. Sample configuration files are contained in 
Chapter 3 and Appendix B. 

>; 

>* <RET>-Continue, R-Repeat section, E-Exit [S]: 

>; 

>; 

> ; 33aS33S3S33SSS33S3aaSSia333S»3aiSaSS33»>llS3S33S3SS8SaSSSSa33aitS3SS 

>; Section 3 - Moving the DECnet Router Server files. 

> * ===3=3333===333332=333S3333Saa>S3a3a3S3333 3a3333=33S3333=a3S3aaS333S3 

>; 

>* Do you want to move the system files? [Y/N]: 
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Section 4 - Building the downline load database 



The downline load and upline dump database is kept on the 
loading host and contains information that the loading 
host uses to load the server software into the 
communications server hardware unit and to receive an 
upline dump of the server memory if the server crashes. 
The following questions allow you to specify: 

1. The host's service circuit used for downline loading 
the server and receiving dumps of the server. 

and 



2. The server's 12-digit Ethernet hardware address. 

RSXINSTAL automatically sets up other parameters in the 
database by using values specified in Section 2 of 
RSXINSTAL, such as the server's node name and service 
password (UNA password). RSXINSTAL defines the loading 
host as the server's maintenance host. The system -images 
and loader files have default names. You determine their 
location in Section 1 of RSXINSTAL. The names and 
descriptions of each are: 

CSVRTR.SYS - The server's system image. 

CSVLOI.SYS - The loadable diagnostics image. 

PLUT02 . SYS - The secondary loader file used for loading 

the server software. 

PLUT03 • SYS - The tertiary loader file used for loading the 
server software. 

RSXINSTAL builds a command file containing Configuration 
File Editor (CFE) commands that define the permanent 
database parameters. After RSXINSTAL completes, you can 
run this command Mile to update the permanent database on 
the host, as explained below. Or, you can use the CFE 
DEFINE NODE command directly to change one or more 
parameters in the permanent database of the host, as 
explained below. 



NOTE 

For security reasons, you may choose not to define 
5 w service password in the downline load 
database. In this way, anyone wishing to load the 
server must specify the password with the LOAD or 
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TRIGGER command, as explained in Section 2.4.1. 



Figure 2-2 shovs how an installer uses CFE to set up the 
database on HOST1 for server RTRDEV. The installer has 
assigned the system images and files to UIC [100,100] on 
LB:. By default, the host is HOST1; that is, KOST1 will 
be RTRDEV' s maintenance host* Appendix C includes the 
DEFINE NODE command and all the possible downline load and 
upline dump parameters. (See the DECnet-RSX System 
Manager's Guide for further information on CFE.) When 
using CFE directly to set up the database, make sure the 
UXCs you specify for parameters correspond to the UICs 
where you have stored the files on the host. 



NOTE 

Make sure you set up a similar database for the 
server node on all other hosts. that are to be used 
for loading the server or for . receiving crash 
dumps . 



Figure 2-2: Setting Up the Downline toad and Upline Dump 
Database on an RSX Host 



>* 4.00 What is the loading host's service circuit-id [S D:"UNA-Q"]: 

>; 

>; This host node may have more than one active circuit. You must 

>; specify the circuit over which service will be performed. 

>; 

>* 4.00 What is the loading host's service circuit- id [S D:"UNA-0"]: 
>* 4.01 What is the server's hardware address [S D: "FF-FF-FF-FF-FF-FF* ] : 



Every Ethernet controller has a unique 12-digit address. This 
hardware address is displayed by running the long diagnostics self 
test. This address will be used by the host to service the DECnet 
Router Server. Enter the address as six pairs of digits separated 
by hyphens (-) . 



This address is the unique address assigned to the 
server's hardware unit. The address is used to 
communicate with the server node before the server 
software has been loaded. If you do not know the address, 
you can have it displayed on the front panel of the 
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You can define these node characteristics in the host's permanent 
database by running CFE with the command file built in this 
procedure (CFERTRDEV.CMD) , as follows: 

>RUN CPE 

Enter filename: DEV: [NETUICjCETAB.MAC 

CFEX3CFERTRDEV 

CFE>sho node RTRDEV 

.... Displays new node characteristics 
CFE>Z 



communications server hardware unit by turning on the 
hardware unit with the TEST button pushed in, as explained 
in Section 5.2 of this manual. The address is displayed 
after the long self -test. After the address is displayed, 
turn the unit off or start it again. 

>* 4.01 What is the server's hardware address CS D:"FF-FF-FF-FF-FF-FF"] : 

>: 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 

>; <EOS> Do you want to: 

>* R-Repeat section, E or <RET>-Exit [Si: 

> 
> 
> 

> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 



Remember to: 

1. Edit your router configuration file. 

2. Update your permanent database with the newly created CFE command 
file. The next time your network is loaded the volatile database 
on the host will be setup. 

3. If your volatile database is set up, then you may trigger or 
load the server. If the volatile database is not set up, then 
downline load your server with the full NCP command: 

NCP LOAD MODE RTRDEV FROM dev : [ nnn , nnn 1 CSVRTR . SYS SER PASS password 

For the server image file ( CSVRTR. SYS) , use the device and 
UIC that you specified in Section 1 of RSXINSTAL. For the 
service password, use the password specified in response 
to question 2.02 in Section 2 of RSXINTAL. 
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>; DECnet Router Server Installation Procedure 
>; Stopped at 13:11:03 on 03-FEB-84 

>; ——»——————«»«»—»————- 

>; 

<EOP> 



The installation procedures copy the following system images 
to the SYS$SYSTEM directory in VMS or the NETUIC account in RSXs 



Table 1 Server System Image Files 



PLUTOCC.SYS 



PLUTOWL.SYS 
CSVLDI.SYS 
PLUT02.SYS 
PLUT03 . SYS 
CSVRTR.SYS 



The console carrier image* This image is used by 
the Remote Console Facility (RCF) • When RCF is 
Invoked from a host, the console carrier image* 
is loaded into the DEUNA device on the server 
node • 

The console carrier loader. This loads the console 
carrier image when RCF is invoked. 

The communications server hardware unit loadable 
diagnostic image. 

The secondary loader, used for down-line loading 
the server software. 

The tertiary loader, used for down-line loading 
the server software. 

The DECnet router server system image. 



NOTE 

The configuration files are copied to the directory in the 
PLUTO PLUTO account. 
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SERVER SOFTWARE SETUP 



When the communications server Is loaded, the software's 
Initialization task uses the network file access routines to read 
network and server software configuration files from the loading 
host. The information that is contained in these files is used to 
set up the server's configuration. Before loading the server 
these files may be edited to reflect the needs of a particular 
configuration. They can also be modified after loading to reflect 
changing needs of the configuration. Any text editor can be used 
to modify the configuration files. The changes take effect when 
the software is reloaded into the server. There are two files 
that need to be modified to configure the server system: 

o Network Configuration File - this file Is set up during the 
installation procedure. During this procedure the user is 
asked to supply the parameters for his network configuration. 
This file is the same for all server products. 

o Server Software Configuration File - this is the file supplied 
with the distribution kit. It may be edited to reflect a 
particular network's needs. This file is specific to each 
server product. 



During installation the files are created with the following 
names and are stored on all loading hosts. These names must not 
be changed. 

o server-node-idSB .CFG - Network Configuration File 

o server-node-idRTR.CFG - Router Server Configuration File 



NOTE 

server-node-id refers to the node name given to 
the server 



To edit the configuration files for a router server node 
BARNEY, using EDT as an example the following command is used: 

EDT>BARNEYSB • CFG 

EDT>BARNEYRTR. CFG 



Example 3 Editing the Router Configuration Files 
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Modifying the Network Configuration File 



The network configuration file contains commands that set up 
the following parameters: 

o The UNA password - prevents unauthorized nodes from reloading 
the server. When the server is loaded with the NCP LOAD or 
TRIGGER commands and a service password is specified with the 
command 9 the server software compares it to the UNA password. 
If the passwords do not match then the loading is denied* If 
a password is not specified with the NCP command the software 
will compare a default service password from the down-line 
load database in the servers loading host. To set the UNA 
password edit the network configuration file command: 

SET LINE UNA-0 PASSWORD hex-password 

o The network privileged password - Identifies the password- used* 
for access control verification at the server node. Users - 
must specify this command when using privileged network 
management functions to access the server node. To set this 
parameter edit the following command: 

SET SYSTEM PASSWORD password 



o The clock frequency for the server node - used by the server's 
Internal clock to keep track of time for such things as the 
time recorded on network event logging messages. The wrong 
frequency specification will record the wrong time in event 
messages. To set the clock frequency edit the following 
command : 

SET SYSTEM LINE FREQUENCY 60 



o A list of backup hosts - These are nodes the server can access 
to record event messages or send up-line crash dumps. Up to 
five backup hosts may be specified. A server looks to the 
backup host list for a node to receive the event message or 
crash dump if it's primary host is unavailable. The server 
requests access to the first node on the list. If it is not 
available the server continues to the next on the list, and so 
on. If none of the hosts is available for a network event 
then the event will not be recorded. If no host is available 
for a crash dump then the server will send a request to the 
multicast address for the Ethernet. After a crash the host 
that receives the dump triggers a reload of the server. To 
specify the list of backup hosts change the following command: 
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SET EXECUTOR BACKUP-HOSTS name 1 , name 2 , name 3 , name 4 , name 5 



NOTE 

If all backup hosts are "busy" and unable to 
receive a crash dump from the server, It sends the 
dump to the multicast address. The node which 
accepts the dump does not have to be one of those 
specified In the backup host list. However only 
those nodes which have the up-line dump database 
built can respond. Also the node that receives 
the dump should be able to reload the server. 



Modifying the Server Configuration File 



The server configuration file is used by the communications 
server to initialize, allocate databases, set up routing 
parameters, etc. Each of the server products has a configuration 
file which defines parameters unique to the product. 



Configuring the Router Server 



The router configuration file is used by the DECent Router 
server to determine the network routing configuration. The file 
contains commands that set up the routing parameters to be used by 
the router server. The router configuration file uses the 
following commands: 

o SET CIRCUIT 

o SET EXECUTOR 

o SET LINE 



Table 2 lists the the parameters that may be defined or modified 
for each of the three components. 
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Table 2 Router Server Component Parameters 



COMPONENT 


PARAMETERS 


EXECUTOR 


Buffer Size 
Segment Buffer Size 
Maximum Address 
Maximum Cost 
Maximum Hops 

Maximum Broadcast Nonrouters 
Maximum Broadcast Routers 


CIRCUIT 


Cost 

Hello Timer 
State 

Router 'Priority 


LINE 


Speed 

Duplex 

Modem 
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LOADING THE SOFTWARE INTO THE SERVER 



A database needs to be set up that contains information 
needed by the loading host to load the software into the server or 
to receive an up-line dump from a crashed server. The database 
contains the following information: 

o The identification of the circuit to be used for the load or 
dump • 

o The service password needed to trigger the bootstrap loader* 
This is the matching password that was set up as the UNA 
password • 

o The name of the file containing the server image to be loaded 
(CSVRTR.SYS) . 

o The name of the file containing the loadable diagnostic image 
(CSVLDI.SYS) . 

o The names of the secondary and tertiary loader files 
containing software for down-line loading (PLUT02.SYS, 
PLUT03.SYS) . 

o The name of the node that will serve as the server's 
maintenance host after it is loaded. This host will receive 
all logged events generated by the server and it will receive 
the up-line dump of server memory should the server crash. 

o The 48-bit Ethernet Hardware Address of the server node. 
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Setting up the Down- line Load/Up-line Dump Database on VMS 



To set up the database on a VMS host use the 
8erver-node-id.COM file. This command procedure allows the 
definition of some parameters such as those for the NCP DEFINE 
NODE command. Other parameters are predefined such as the names 
of the loadable diagnostic image, dump files , and loader files. 
Example 4 shows the NCP DEFINE NODE command, set up at loading 
host VMSHOST, defining the database for the DECnet Router Server 
node BARNEY. 



NCP>DEFINE NODE 134 NAME BARNEY - 
DUMP FILE BARNEY. DMP - 
HARDWARE ADDRESS AA-00-03-00-00-06 - 
HOST VMSHOST 

DIAGNOSTIC FILE LB : [ 100, 100 ] CSVLDI . SYS - 
LOAD FILE LB:[100,100]CSVRTR.SYS - 
SERVICE CIRCUIT UNA-0- 
SERVICE PASSWORD FF7A - 

SECONDARY LOADER LB : [ 100 , 100 ] PLUT02 . SYS- 
TERTIARY LOADER LB : [ 100 , 100 ] PLUT03 . SYS 



Example 4 Setting Up the Down-line Load/Up-line Dump Database 
on a VMS Host 



The NCP command file asks the following questions to fill in the 
above command : 

o Server node-id - the name of the server node 

o Server node number - the node number chosen for the server 
node 

o Hardware address - 48-bit Ethernet Hardware Address assigned 
to the DEUNA 

o Maintenance host - the name of the node that will be the 
maintenance host for the server after its loaded. The default 
host is the loading host. 

o Service circuit - the UNA circuit to be used for down-line 
loading or up-llne dumping. 

o Service password - the password required to enable the 
bootstrap mechanism on the server node. This password must 
match the UNA password in the network configuration file. 
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o Store file - the NCP file can be stored for future use, 
executed now, or both* If the file is to be stored answer YES 
and the next three questions will be displayed. 

o File name - the name to be given to the NCP command file* 

o Storage device - the name of the device where the file will be 
stored • 

o Storage directory - the name of the directory on which the 
file is stored* 

o Execute file - Do you want to execute this file now? 



NOTE 

These commands change only the permanent database 
so for them to be executed the the server must be 
rebooted, or the NCP>SET SYSTEM command used 
(after NCP>CLEAR SYSTEM ALL and N£P>SET NODE ALL) 



o More servers to define - answer YES, to define parameters for 

other servers, and the above procedures will be repeated* If 

there are no other servers then the installation procedure is 
complete and the answer to this question is NO* 



$! NCP Configuration file for node BARNEY 



$ 


ncp 


purge node BARNEY all 




$ 


ncp 


purge node 4 all 




$ 


ncp 


define node 4 name BARNEY 




$ 


ncp 


define node 4 diagnostic file CSVLDI 


.SYS 


$ 


ncp 


define node 4 dump file SYS$SYSROOT: 


[PLUTO] BARNEY. DMP 


$ 


ncp 


define node 4 hardware address AA-00-03 


-00-00-06 


$ 


ncp 


define node 4 host VMSHOST 




$ 


ncp 


define node 4 service circuit UNA-0 




$ 


ncp 


define node 4 service password FF7A 




$ 


ncp 


define node 4 load file CSVRTR.SYS 




$ 


ncp 


define node 4 secondary loader PLUT02 . SYS 


$ 


ncp 


define node 4 tertiary loader PLUT03 


.SYS 



Example 5 NCP Command Pile for Router Node BARNEY 
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Setting up the Down-line Load/Up-line Dump Database on RSX 



To set up the down-line load database on an RSX host the 
Configuration File Editor (CFE) is used* A similar database has 
to be set up on all the nodes that will be used for loading the 
server or for receiving crash dumps* The CFE command, set up at 
loading host RSXHOST, defining the database for the DECnet Router 
Server node BARNEY* 



CFE>DEFINE NODE 136 NAME BARNEY - 
DUMP FILE BARNEY *DMP - 
HARDWARE ADDRESS AA-00-03-00-00-06 - 
HOST RSXHOST 

DIAGNOSTIC FILE LB : [ 100 » 100 ] CSVLDI . SYS - 

LOAD FILE LB: [ 100, 100]CSVRTR.SYS - 

SERVICE CIRCUIT UNA-0 - 

SERVICE PASSWORD FF7A - 

SECONDARY LOADER [100, 100 ] PLUT02 • SYS 

TERTIARY LOADER [ 1 00 , 1 00 ] PLUT03 • SYS 

Example 6 Setting Up the Down-Line Load/Upline Dump Database 
on an RSX Host 
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Down-Line Loading Procedures 



There are two ways to initiate the down-line load of the 
server software: 

o Use the NCP LOAD NODE or TRIGGER NODE command. 

o Press the START button on the front of the communications 
server • 



NOTE 

This assumes that the hardware is already turned on. If 
not then the load will start automatically when the switch 
is turned to the ON position. 



Both methods produce the same results when loading the server for 
the first time. There are several steps the user needs to take 
before trying to load the server: 

o The communications server hardware is powered up. 

o The line associated with the UNA circuit over which the 
down-line load will take place is already loaded at the host, 
and the UNA circuit is set to the ON state. 

o The UNA circuit at the host is service enabled (NCP SET 
CIRCUIT UNA-0 SERVICE ENABLED). 

o All operating system and configuration files needed to load 
the server have been copied to the approprate places on the 
backup hosts. 

o Optionally event logging at the most accessible host, usually 
the loading host, should be enabled. When a server is loaded, 
the software generates several event messages concerning the 
stage of the loading process and of the success or failure of 
the process • 
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Boot Button Initiated Load 



The loading process is started at the server hardware unit by 
pressing the start button on the front panel. Figure 1 shows the 
front panel of the communications server* When the load is 
Initiated the server hardware responds by sending a multicast 
reques t-to-load message to host nodes on the Ethernet* The host 
that loads the server is the first host to respond that contains 
the down-line load Information for that server* 



Fault 



Um Card Lofte Cable 

o o o 



0000 
UJJtJU. 



Off 



On 



Tart Start 

ED £D 




MKVS4-087? 



Figure 1 Communications Server Front Panel 



The load process takes several minutes. During a successful 
load, the server's digital displays will be blinking, then L 30 
will be dlplayed. After about 30 seconds the display will show L 
5n. The n rotates from 0-7 repeatedly, indicating that the 
software image is being loaded. The server node is up when a 
cyclic pattern shows on the server's digital displays. While the 
software is running the DECnet node address will alternate with 
the cyclic pattern. 



NOTE 



If an error occurs during or after the loading 

process, one of the fault indicators will light up 

and the digital display will show error 
information • 
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Host Initiated Load 



Loading the server software from a host is done by using the 
NCP LOAD or TRIGGER command .These commands can be issued from a 
terminal either on the loading host or from a remote node 
connected to the loading host that has the server node defined in 
It '8 database. The LOAD command causes the load to begin quicker 
but the TRIGGER command releases the terminal quicker. 

NOTE 

The TRIGGER command completes 
starts it's self tests while 
doesn't complete until the image 



when the server 
the LOAD command 
is loaded. 



Using The LOAD Command 



The LOAD command forces the load from the host at which you 
execute the command. In addition the LOAD command allows the user 
to provide more Information or override information in the 
volatile down-line load database. 

The LOAD command is issued in the following formats: 

NCP>LOAD NODE server-node-id [SERVICE PASSWORD hex-password] 

or 

NCP>LOAD VIA circuit-id [NAME node-name] 

[PHYSICAL ADDRESS E-address] 
[SERVICE PASSWORD hex-password] 



NOTE 

When using the LOAD VIA command to specify the 
circuit to use when loading the server the server 
node name or the physical address must be 
specified • 

Example 7 shows the NCP LOAD command being used to load a DECnet 
Router • 
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NCP>SET LINE UNA-0 ALL 

NCP>SET CIRCUIT UNA-0 SERVICE ENABLED STATE ON 
NCP>LOAD NODE RTRDEV 



Example 7 Loading the Communications Server Using the NCP LOAD 
Command 

The LOAD command allows the user to override any of the 
following default, parameters defined in the running down-line load 
database of the loading host: 

o HOST node-id - a node other than the current host to receive 

logged events and up-line dumps generated by the server node. 

This node must be reachable from the loading host or be the 
loading host itself* 

o FROM file-id - identifies the server software image file that 
the user wishes- to load* 

o SECONDARY LOADER, TERTIARY LOADER file-id - identifies the 
loader programs* 

o PHYSICAL ADDRESS E-address - either the Ethernet hardware 
address or the extended DECnet node address of the server 
node . 

o SERVICE PASSWORD hex-password - specifies the password 
required by the server node for starting the load operation. 



NOTE 

If the NCP LOAD command is issued while the TEST 
button on the server is in, then NCP ignores the 
state of the TEST button and sends the server 
software, and not the diagnostic image. 
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Using The TRIGGER Command 



The TRIGGER command has the same effect as loading the server 
by pushing the start button. The TRIGGER command starts the 
bootstrap mechanism on the server which in turn sends a multicast 
request-to-load message to all nodes on the Ethernet. The TRIGGER 
command is Issued in the following ways: 



NCP>TRIGGER NODE server-node-id [SERVICE PASSWORD hex-password] 

[PHYSICAL ADDRESS E-address] 

or 

NCP>TRIGGER VIA circuit-id PHYSICAL ADDRESS E-address 

[SERVICE PASSWORD hex-password] 



The TRIGGER command uses - the information from the server 
node's down-line load database in the loading host* The TRIGGER 
VIA command is used from a host node on which the database has not 
been defined. The following procedures take place when the 
TRIGGER command is issued: 

o The host where the command is issued sends the trigger to the 
server over the specified circuit. 

o The server responds by sending a request-to-load message to 
ALL hosts on the Ethernet. 

o The first host to respond, loads the server. 

The Example 8 shows the TRIGGER command being used to load a 
Router Server (RTRDEV) over circuit UNA-0. 



NCP>SET LINE UNA-0 ALL 

NCP>SET CIRCUIT UNA-0 SERVICE ENABLED STATE ON 
NCP>TRIGGER NODE RTRDEV 



Example 8 Loading the Communications Server Using the NCP 
TRIGGER Command 
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NOTE 

If the SET CIRCUIT SERVICE DISABLED command is 
used the host from which the command is issued can 
never be the loading host. 

If the TRIGGER command is issued while TEST button 
on the server is in, then the host will load the 
Loadable Diagnostic Image Instead of the server 
software • 



Expected Event Messages 



The loading process goes through the following three phases 
and may take up to several minutes to complete. 

1. A primary loader, contained in the server's DEUNA R0M 9 loads 
the secondary loader (PLUT02.STS) into the DEUNA and causes it 
to begin executing. 

2. The secondary loader loads the tertiary loader (PLUT03.SYS) 
into server memory and starts the tertiary loader. 

3. The tertiary loader loads the system image (CSVRTR.SYS) into 
server memory. The tertiary loader also passes host supplied 
parameters to the system image (server's node name, node 
number, and hosts node number). Finally the tertiary loader 
starts the system image. 



During each phase of the load, the host issues two event 
messages. The first event message of the pair indicates the load 
phase that has been requested (eg. the secondary loader has been 
requested to load the tertiary loader). The second message of the 
pair indicates whether the load was successful or not. Table 3 
contains a list of expected events during the loading of server 
sof tware • 
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Table 3 Installation Event Message Classes 



EVENT 
225 



MEANING 



Errors that occur before and during the 
Initialization of the network configuration 
file. 



226 



Errors that occur during Initialization of 
the Router Server configuration file. 



229 



Errors that occur anytime after the server 
software is running* These include protocol 
errors as well as other uncommon events 
involving the server software. 



Example 9 shows some typical events that can be expected 
the loading and initialization of the server software. 



DECnet event 0.3, automatic line service 
Prom node 224 (BARNEY), l-JUL-1983 10:59:03.55 
Circuit UNA-0, Load, Requested, Node * 225 (WILMA) 
Pile * PLUT02 • SYS, Secondary loader 



ZZZZZZZZZZZ OPCOM l-JUL-1983 10:59: 10.8'* 
Message from user DECNET 

DECnet event 0.3, automatic line service 
Prom node 224 (BARNEY), l-JUL-1983 10:59:03.55 
Circuit UNA-0, Load, Requested, Node - 225 (WILMA) 
Pile * PLUT02.SYS, Secondary Loader 



ZZZZZZZZZZZ OPCOM l-JUL-1983 10:59:19.68 
Message from user DECNET 

DECnet event 0.3, automatic line service 
From node 224 (BARNEY), l-JUL-1983 10:59:03.78 
Circuit UNA-0, Load, Successful, Node - 225 (WILMA) 
File - PLUT02 • SYS , Secondary Loader 
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ZZZZZZZZZZZ OPCOM l-JUL-1983 10:59:28.37 

Message from user DECNET 

DECnet event 0.3, automatic line service 

From node 224 (BARNEY), l-JUL-1983 10:59:05.03 

Circuit UNA-0, Load, Requested, Node - 225 (WILMA) 

File - PLUT03 • SYS , Tertiary loader 



ZZZZZZZZZZZ OPCOM l-JUL-1983 10:59:37.00 
Message from user DECNET 

DECnet event 0.3, automatic line service 
From node 224 (BARNEY), l-JUL-1983 10:59:06.41 
Circuit UNA-0, Load, Successful, Node - 225 (WILMA) 
File - PLUT03. SYS , Tertiary loader 

ZZZZZZZZZZZ OPCOM l-JUL-1983 10:59:45.65 
Message from user DECNET 

DECnet event 0.3, automatic line service 
From node 224 (BARNEY), l-JUL-1983 10:59:06.82 
Circuit UNA-0, Load, Requested, Node - 225 (WILMA) 
File * CSVRTR. SYS, - Operating system 

DECnet event 0.3, automatic line service 
From node 224 (BARNEY), l-JUL-1983 11:00:14.27 
Circuit UNA-0, Load, Successful, Node - 225 (WILMA) 
File - CSVRTR. SYS, Operating system 

ZZZZZZZZZZZ OPCOM l-JUL-1983 11:00:20.72 
Message from user DECNET 

DECnet event 0.3, automatic line service 
From node 224 (BARNEY), l-JUL-1983 11:00:14.27 
Circuit UNA-0, Load, Successful, Node - 225 (WILMA) 
File * CSVRTR. SYS, Operating system 

DECnet event 225.0 

From node 225 (WILMA), l-JUL-1983 11:00:45.76 

Parameter #0 * Server initializing, Identification - RTR 1 

DECnet event 4.15, adjacency up 

From node 225 (WILMA), l-JUL-1983 11:01:55.76 

Circuit UNA-0, Adjacent node * 224 (BARNEY) 

DECnet event 4.15, adjacency up 
From node 225 (WILMA), 11:02:15.27 
Circuit UNA-0, Adjacent node - 320 (FRED) 



Example 9 Typical Event Messages During Server Initialization 
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If the software detects errors la the configuration flies, 
the event message shows which command Is In error as well as the 
nature of the error. The reported errors should be corrected and 
the software loaded again* 



COMMUNICATIONS SERVER INITIALIZATION 



After the system has been loaded, It starts the 
Initialization process: 

o RSX Executive starts 

o Communications Executive starts 

o NTINIT starts up the DECnetnode (turns the Executor on) 
o PAM and UNA microcode Is loaded 

o UNA driver changes the UNA physical address from the hardware 
address to the extended DNA address 

o LED task starts - displays the cyclic light pattern 

o SBINIT starts 

- Walts for the network to come up 

- Issues event to the host - Server Initializing 

- Uses NICE to read node names from the host 

Uses DAP to read <node>SB.CFG file from the host 
Starts the server product Initialization task 
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INSTALLATION CERTIFICATION PROCEDURES 



Once the software is loaded without error and the server 
coses up, the next step is to perform the Installation Checkout 
Procedures (ICP). This is an indirect command file supplied with 
the server software that checks the connectivity between the 
server node and all it's adjacent nodes* The ICP is invoked using 
the following commands: 

$@SYS$SYSROOT: [PLUTO] CSVRTRICP 

or 

><? dev: [uic] CSVRTRICP 
NOTE 

The dev and [uic] refer to the device, and UIC of 
the Pluto account. 



There is a specific ICP designed for each of the server products* 
Figure 2 shows a DECnet Router configuration tested by 
CSVRTRICP.COM. 
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$@CSVRTRICP 



$ SET NOVERIPY 

! 

!Thi8 procedure runs a loop test to each adjacent node to the 
tDECnet Router Server and reports the status of the circuit. 
! reference the System Managers Guide if errors are not familiar • 
! 

!Tou may edit this procedure to test any lines you wish. 
! 

$0N CONTROL_Y THEN EXIT 

$INQUIRE NODE "Please enter the DECnet Router Server naie" 
$INQUIRE PASS "Please enter 'NODE' password 

$ 



$SET 


VERIFY 






















$NCP 


TELL 


'NODE' 


USER [ 


1,1] 


PASS 


'PASS' 


SET 


NODE 


LCI 


CIR 


LC- 


1 


$NCP 


TELL 


'NODE' 


USER [ 


1,1] 


PASS 


'PASS' 


LOOP 


NODE 


LCI 








$NCP 


TELL 


'NODE' 


USER [ 


1,1] 


PASS 


'PASS' 


CLE 


NODE 


LCI 


CIR 






$NCP 


TELL 


'NODE' 


USER [ 


1,1] 


PASS 


'PASS' 


SET 


NODE 


LC2 


CIR 


LC- 


2 


$NCP 


TELL 


'NODE' 


USER [ 


1,1] 


PASS 


'PASS' 


Loop 


NODE 


LC2 








$NCP 


TELL 


'NODE' 


USER [ 


l»*U 


PASS 


'PASS' 


CLE 


NODE 


LC2 


CIR 






$NCP 


TELL 


'NODE' 


USER [ 


1,1] 


PASS 


'PASS' 


SET 


NODE 


LC3 


CIR 


LC- 


3 


$NCP 


TELL 


'NODE' 


USER [ 


1,1] 


PASS 


'PASS' 


LOOP 


NODE 


LC3 








$NCP 


TELL 


'NODE' 


USER [ 


1,1] 


PASS 


'PASS' 


CLE 


NODE 


LC3 


CIR 






$NCP 


TELL 


'NODE' 


USER [ 


1,1] 


PASS 


'PASS' 


SET 


NODE 


LC4 


CIR 


LC- 


4 


$NCP 


TELL 


'NODE' 


USER [ 


1,1] 


PASS 


'PASS' 


LOOP 


NODE 


LC4 








$NCP 


TELL 


'NODE' 


USER [ 


1,1] 


PASS 


'PASS' 


CLE 


NODE 


LC4 


CIR 






$NCP 


TELL 


'NODE' 


USER [ 


1,1] 


PASS 


'PASS' 


SET 


NODE 


LC5 


CIR 


LC- 


5 


$NCP 


TELL 


'NODE ' 


USER [ 


1,1] 


PASS 


'PASS' 


LOOP 


NODE 


LC5 








$NCP 


TELL 


'NODE' 


USER [ 


1,1] 


PASS 


'PASS' 


CLE 


NODE 


LC5 


CIR 







!$NCP TELL 'NODE ' USER 
!$NCP TELL 'NODE' USER 
!$NCP TELL 'NODE' USER 



I 

!$NCP 
! $NCP 

!$NCP 
t 

!$NCP 
! $NCP 
! $NCP 
$EXIT 



TELL 'NODE' USER 

TELL 'NODE' USER 

TELL 'NODE' USER 

TELL 'NODE' USER 

TELL 'NODE' USER 

TELL 'NODE' USER 



PASS 'PASS' SET NODE LC6 CIR LC-6 
PASS 'PASS' LOOP NODE LC6 
PASS 'PASS' CLE NODE LC6 CIR 



PASS 'PASS' 
PASS 'PASS' 
PASS 'PASS' 

PASS 'PASS' 
PASS 'PASS' 
PASS 'PASS' 



SET NODE LC7 CIR LC-7 
LOOP NODE LC7 
CLE NODE LC7 CIR 

SET NODE LC8 CIR LC-8 
LOOP NODE LC8 
CLE NODE LC8 CIR 



Example 10 ICP Test for DECnet Router Configuration 
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gure 2 DECnet Router Configuration Tested by ICP Example 
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COPYING FILES TO BACKUP HOSTS 



After checking that the server is working properly, the 
software images and files are copied to all the backup hosts that 
were specified in the network configuration file. These files 
must be copied to the proper place on the host system: 

o VMS backup hosts 

- Server system image, diagnostics system image, and the 
loader files reside in SYS$SYSTEM. 

Configuration files and the ICP command file reside in the 
PLUTO PLUTO account. 



o RSZ backup hosts 

- Server system image, diagnostics system image, and loader 
files reside In' NETTJIC or. whatever server UIC has been 
chosen • 

Configuration files and the ICP command file reside In the 
PLUTO/PLUTO account. 



Copy the files to their respective hosts by using the VMS COPT or 
RSX NFT utilities. 

Once the files have all been copied to their respective 
places the final steps in the installation are: 

o Set up the Down-line load/Up-line dump database on the backup 
hosts and on any host which will be used to accept a server 
dump • 

o Make sure that all copied files have protections set for WORLD 
READ 

o Set up the PLUTO account on all backup hosts 



38 



APPENDIX A 
NETWORK CONFIGURATION PILE 

Configuration File - ' server-id ' SB .CFG 

1. Defining the UNA password (viewed by hosts as the service password) . 
Default if invalid or missing: NO PASSWORD. SET 

SET LINE UNA-0 PASSWORD FFFF 

2. Defining the Network Verification password. 
Default if invalid or missing: NO PASSWORD SET 

SET SYSTEM PASSWORD PRIV 

3. Setting the clock frequency to 50 Hz. 
Default if invalid or missing: 60 Hz. 

SET SYSTEM LINE FREQUENCY 60 

4. Backup host node list. 

Default: server's maintenance host 

SET EXECUTOR BACKUP HOSTS A,B,C,D 



A-1 



APPENDIX B 
DECNET ROOTER SERVER CONFIGURATION FILE 



DECnet Router Server Initialization File 
Copyright (c) 1983 by 

Digital Equipment Corporation , Maynard, .Mass. 
File name - "Server's node name"RTR.CFG 



This configuration file resides on the PLUTO/PLUTO account or 
General DECnet account of the downline loading host system* This 
file uses all the default values for configuring a DECnet Router 
Server node. Note all values are in decimal. 



1. Set the MAXIMUM ADDRESS in the DECnet network. The legal 
range for this parameter is 2 to 1023 inclusive. The 
default value for the MAXIMUM ADDRESS parameter is 255. 



SET EXECUTOR MAXIMUM ADDRESS 255 



2. Set the maximum number of routing nodes (excluding this 
node) on the Ethernet simultaneously. The legal range for 
the BROADCAST ROUTERS parameter is 1 to 33 inclusive. The 
default value for this parameter is 10. 



SET EXECUTOR MAXIMUM BROADCAST ROUTERS 10 



3. Set the maximum number of nonrouting nodes on the Ethernet 
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simultaneously. The legal range for 
NONROUTERS parameter Is to 1022 Inclusive, 
value for this parameter is 32. The number 
will be set to the maximum address minus one 
of nonrouters is greater than the maximum 
one • 



the BROADCAST 
The default 
of nonrouters 
if the number 
address minus 



SET EXECUTOR MAXIMUM BROADCAST NONROUTERS 32 



4. Set the total number of hops from the DECnet Router Server 
to any other reachable node in the network* A remote node 
is unreachable over a path if the number of hops required 
to get to it exceeds the value set for this parameter* The 
legal range for the HOPS parameter is 2 to 30 inclusive* 
The default value for this parameter is 20* 



SET EXECUTOR MAXIMUM HOPS 20 



5* Set the total cost from the DECnet Router Server to any 
other reachable node in the network* A remote node is 
unreachable over a path if the cost required to get to it 
exceeds the value set for this parameter* The legal range 
for the COST parameter is 2 to 1022 inclusive* The default 
value for this parameter is 1022* 



SET EXECUTOR MAXIMUM COST. 1022 



6* Set the BUFFER SIZE for the DECnet Router Server* These 
buffers are used for the intermediate storage of all user 
data being transmitted or received. Legal range for the 
BUFFER SIZE parameter is 246 to 1484 inclusive. The 
default value for this parameter is 576* 



SET EXECUTOR BUFFER SIZE 576 



7. Set the SEGMENT BUFFER SIZE. This parameter allows nodes 
with different buffer sizes to communicate efficiently. 
The legal range for the SEGMENT BUFFER SIZE parameter is 
246 to 1466 inclusive. The default value for this 
parameter is 576. 



B-2 



OBCNET ROUTER SERVER CONFIGURATION FILE 



SET EXECUTOR SEGMENT BUFFER SIZE 576 



8* Set the line characteristics (SPEED, DUPLEX, MODEM control) 
for each point-to-point connection from the DECnet Router 
Server. The options for each parameter are the following; 

The speed range varies depending on your configuration* 
Check the DECnet Router Server Installation guide for the 
proper values* The total bandwidth for the point-to-point 
lines must not exceed 500 kilobaud. 



The duplex parameter for the line can be DUPLEX FULL or 
DUPLEX HALF. 



The modem control parameter can be MODEM YES or MODEM NO* 

* 

The default values for these parameters are SPEED 9600,. 
DUPLEX FULL and MODEM NO. The legal devices are LC-1 
through LC-8 and LC-*. 



SET LINE LC-1 SPEED 9600 
SET LINE LC-2 SPEED 9600 
SET LINE LC-3 SPEED 9600 
SET LINE LC-4 SPEED 9600 
SET LINE LC-5 SPEED 9600 
SET LINE LC-6 SPEED 9600 
SET LINE LC-7 SPEED 9600 
SET LINE LC-8 SPEED 9600 



DUPLEX FULL MODEM YES 
DUPLEX FULL MODEM YES 
DUPLEX FULL MODEM YES 
DUPLEX FULL MODEM YES 
DUPLEX FULL MODEM YES 
DUPLEX FULL MODEM YES 
DUPLEX FULL MODEM YES 
DUPLEX FULL MODEM YES 



9. Set the circuit characteristics (COST, HELLO TIMER, STATE) 
for the point-to-point circuits from the DECnet Router 
Server. The legal range for the cost parameter is 1 to 25 
inclusive. This sets the path cost between the DECnet 
Router and the adjacent node on the circuit. The legal 
range for the HELLO TIMER parameter is 3 to 8191. The 
HELLO TIMER is the rate in seconds that idle transport 
messages are sent to maintain reachability. The options for 
the state parameter are STATE ON or STATE OFF. The default 
values for COST, HELLO TIMER and STATE are 1, 15 seconds 
and off respectively. 



SET CIRCUIT LC-1 COST 1 

SET CIRCUIT LC-2 COST 1 

SET CIRCUIT LC-3 COST 1 

SET CIRCUIT LC-4 COST 1 



HELLO TIMER 15 STATE OFF 

HELLO TIMER 15 STATE OFF 

HELLO TIMER 15 STATE OFF 

HELLO TIMER 15 STATE OFF 
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SET CIRCUIT LC-5 COST 1 

SET CIRCUIT LC-6 COST 1 

SET CIRCUIT LC-7 COST 1 

SET CIRCUIT LC-8 COST 1 



HELLO TIMER 15 STATE OFF 
HELLO TIMER 15 STATE OFF 
HELLO TIMER 15 STATE OFF 
HELLO TIMER 15 STATE OFF 



10. Set Che circuit UNA-0 parameters (COST, ROUTING PRIORITY, 
HELLO TIMER). The COST and HELLO TIMER parameters have the 
same attributes and defaults as described above for LC 
circuits. The ROUTING PRIORITY parameter designates which 
router will serve the Ethernet* If two routing nodes have 
the same priority, then the node with the higher node 
address will be the designated router for the Ethernet* 
The legal range for the ROUTING PRIORITY parameter is to 
127 inclusive* The default for this parameter is 100* 



SET CIRCUIT UNA-0 COST 1 ROUTING PRIORITY 100 HELLO TIMER 15 



11* Set the TRANSMIT PASSWORD, which the executor node must 
transmit to an adjacent node during a node Initialization 
sequence* The password is one to eight ASCII characters* 
The default for this parameter is no password* 

SET EXECUTOR TRANSMIT PASSWORD DECNET 



12. Set the RECEIVE PASSWORD, which the executor node expects 
to receive from an adjacent node during a node 
initialization sequence* The password is one to eight 
ASCII characters* The default for this parameter is no 
password • 

SET EXECUTOR RECEIVE PASSWORD DECNET 
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INTRODUCTION 

The Communications server hardware consists of : 

o A dedicated PDP-11/24 

o 512 KB of memory 

o The Protocol Assist Module (PAM) 

o Appropriate line cards 

o DIGITAL Ethernet to UNIBUS Adapter (DEUNA) 

o Console Boot Terminator (CBT) 



The PAM provides the interface between a terminal, remote 
DECnet node or PPSN and the Communications server. The PAM moves 
characters between line cards and server memory. It can transmit: 
or receive characters using a number of data link protocols 
including DDCMP and HDLC. 

The Communications Server Software is made up of two basic 
parts: the Server Base and given server product software. The 
Server base is a set of components common to all server products; 
it provides the foundation on which the products are built. The 
Server Base implements generic DNA Phase IV, including a 
Communications Executive (CEX), capabilities for down-line 
loading, up-line dumping, and maintenance facilities. The server 
software is layered on top of this base forming the server 
product. This product is distributed as a system image, installed 
on an Ethernet host, modified by means of a configuration file, 
and down-line loaded into the communications server. 

The DEUNA provides the interface between the Communications 
server and the Ethernet. It is responsible for receiving and 
transmitting data to or from an Ethernet host. 

This module covers the major components, data structures, and 
data flow for the Communications server software, and the DECnet 
Router server. It is divided Into 3 sections describing the 
Server Hardware (PAM), Server Base, and the DECnet Router server 
product • 
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COMMUNICATIONS SERVER HARDWARE 

o PDP-11/24 with 512 KB memory 
o DEUNA - to connect to the Ethernet 
o PAM (Protocol Assist Module) 
Intelligent interface 

Supports DDCMP, HDLC, and asynchronous protocol for 
terminals 

- Supports up to eight line cards 

M3100 - 1 synchronous line, up to 19.2 KB 

M3101 - 1 synchronous line, up to 500 KB 

M3102 - 2 asynchronous lines, up to 19.2 KB 

o Extended Unibus to allow 22-bit addressing by the PAM 
o No Unibus Mapping Registers 
o No disk or console terminal 

o LED on the front panel used for diagnostics, fault 
indications, and node identification 
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Flgure 1 Co^unications Server Hardware Components 
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PROTOCOL ASSIST MODULE (PAM) 

o Moves characters between the line cards and server memory. 

o Assembles received messages Into receive buffers in server 
memory . 

o Transmits/receives messages in any one of the following 
protocol types : 

- Asynchronous (for terminals) 

- DDCMP 

- HDLC 



o The Pam is loaded with either the terminal or the protocol 
microcode • 

o A specific PAM line is limited to 'only one protocol at any 

particular time. 

PAM Operation 



o Receiving data 

Characters enter the line cards one character at a time. 

- The line cards are scanned by the PAM hardware, the 
characters are moved into a silo buffer, and the PAM 
microcode is notified. 

- Protocol header is stripped off on protocol lines and the 
CRC is checked. 

- The microcode moves the data from the silo into receive 
buffers (RDBs) in server memory (done by DMA). 

Each RDB is pointed to by a Receive Segment Descriptor. 

There are 16 Receive Segment Descriptors that are 
arranged into a ring buffer. 

Each segment descriptor points to one of the RDBs 
allocated for the PAM. 

Receive Segment Descriptors contains pointers to a 
particular RDB, status information, and the number of 
bytes placed into the buffer. 
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Once the RDB is full, or the message is completed, the 
status Is set in the segment descriptor for that RDB 
(RCVCMP) . 

The PAM microcode generates a "receive complete" (RCVCMP) 
to the next level process. 



o Transmitting data 

The PAM microcode transfers data, 1 word at a time, from 

transmit buffers (LDBs) in server memory into a PAM buffer 
(local store) via DMA. 

From the local store, the characters are moved to the line 

cards, the protocol headers are added, and the packet is 
transmitted • 



NOTE 

There are two network buffers allocated for each 
line using the M3100 or M3102 (19.2 KB) line cards 
and four network buffers allocated for each line 
using the M3101 (500 KB) line card. 
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Figure 2 Integration of PAM Components 
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SERVER BASE 

The server base is made up of an RSX-11S system with DECnet 
capabilities . 
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Figure 3 Communications Server Memory Layout (Server Base) 
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Communications Executive (CEX) 
o A set of modules used to help run the communication processes, 
o In the communications server, it resides in CEXPAR (DSR space) 
o Provides: 

- Interprocess communication routines that allow processes 
to communicate with each other. 

- Process scheduling routines that allow DECnet processes to 
schedule other DECnet processes for execution. 

- Buffer management routines that allocate/deallocate main 
memory buffers from available buffer pools. 

- Timer support routines that provide processes with logical 
timers • 

- Modem control routines that support modem handling for 
lower level processes (actually resident in AUX). 

- Common routines used by the communication processes. 

System Level Interface (SLI) 

o Allows processes to schedule one another and convey data 
buffers. 

o Utilizes the interprocess communications mechanisms of the 
CEX. 

o Functions incude: 

Request a logical link 
Accept a logical link 

- Send data 

o Used in place of the standard QIO interface provided by RSX. 
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Communication Processes 

LLC Processes 
o NT.AUX (Auxiliary Process) 

Non-time-critical extension of the CEX 
- Functions : 

Buffer allocation failure recovery 
Powerfail recovery 
Modem control 
Timer services 

Fork processing and process dispatch 

Allocation/deallocation of buffers from network pool 
(NTPOOL) 



o NT.ECL (End Communications Layer) 

- Accepts QIO requests from user tasks for logical links 
(NS: Driver) 

Processes time critical requests such as SND$, REC$, and 
XMI$ (all others are sent to NETACP for processing) 

Contains time critical code for logical link processing 

- Implements the NSP protocol 

o NT.XPT (Routing Process) 

Provides DECnet routing functions 

Checks if the selected channel is broadcast or non 
broadcast 

Checks visit counts 
Builds routing header 
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o NT.DTR 

System Level Interface version of DTR 
Used for running DTS tests 

o NT.EVL (Event Logging Process) 

- Creates records of network events 

- Sets up event buffers 

- Dispatches the events to sink nodes 
Sends events to EVC... 

o NT.DLX (Direct Line Access) 

Accepts and processes QIO requests from user tasks for DLX 
access (NX: Driver) 



DLC Processes 
o NT.APC 

Auxiliary PAM Control process 

Used when PAM lines are running DDCMP 

- Provides compatibility for HDLC and asynchronous terminals 
that use a software DLC. The APC provides PAM with 
someplace to go when the lines are running DDCMP (which 
PAM handles in microcode). 

o NT.EPM (Ethernet Protocol Manager) 
Protocol multiplexer 

- Controls the users communicating on the Ethernet 

Uses protocol address pairs to identify who is 
communicating and what type of protocol is being used. 
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DDM Processes 
o I/O driver for a communication device 

o Executes as a result of either a device interrupt or an I/O 
request from a DLC 

o Primary functions : 

Starting and stopping the device 

Giving the device buffers to receive and transmit 
Retrieving/setting device characteristics 
- Terminating the current operation on the device 

Providing special notifications to higher level processes 

o NT. UNA 

DEUNA interface to the Ethernet 

o NT.PAM 

Provides PAM support for asynchronous terminals, DDCMP, 
and HDLC 
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PAM MICROCODE 

DNAMC (UNA Microcode) 
o UNA ECO microcode 

o Loaded with the help of AUX and MLD by drivers 
o Loaded after the CEX enables the DEUNA 

o Not microcode but rather a common area for the microcode 
PAMMC1 

o The synchronous PAM microcode 

o Loaded with the help of AUX by drivers 

o Loaded after the first "enable" is sent 
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MAJOR TASKS 

NTINIT (Network Initializer) 

o Used to start up the network after a down-line load 

o Sets down-line load parameters into database 

o Enables lines and circuits 
MLD... (General Microcode Loader) 

o Supports PAM and UNA microcode 

o Calls MLP; the PAM microcode loader to perform device specific 
parts of the microcode loading 

EVC... (Event Collector) 

o Server task for the EVL process 

o Dispatches event records to a console or monitor terminal, 
residing on a host that is on or off the Ethernet. 

NMVACP (Network Management Volatile ACP) 

o Executes NCP or Nice commands as requested by NM: 

o Makes changes to volatile database only 
NMDRV (Network Management Device Driver - NM:) 

o Provides initial checking for given NCP or NICE requests 

o Gives valid requests to NMVACP for processing 
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NETACP (DECnet Network ACP) 
o Works with NS: (ECL) 

o Processes user QIO requests from NS : that are not considered 
time critical (OPN$, CLS$, CON$, DSC$, ACC$, etc) 

o Handles incoming calls by requesting tasks for them 

o Notifies user tasks when network events occur 

o Contains session control routines 

o Contains line control routines for routing (line stop, MOP 
message received dispatch, etc.) 

LED... 

o Implements the LED display on the Server 
RED... (Remote Examine and Deposit) 

o Server task for the Server On-line Debugging tool (POD) 

o Resides on the Server 
NIC... (Network Information and Control Executor) 

o Serves network management requests from remote nodes 

o Implements the NICE protocol 
LOO..., MIR... 

o Network Management Loop and Mirror tasks 
SBI... (Server Base Initializer) 

o Server Base Initializing task 

o Defines logical line card names (eg. LC-1 for PAM-0-0) 

o Sets up the server's node database from the host using NICE 
protocol (equivalent to NCP> TELL $HOST SHOW KNOWN NODES) 

o Reads the network configuration file <node> SB . CFG file on the 
host (using Network File Access Routines) 

o Starts the Server Product Initializer task 
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SPI... (Server Product Initializer) 
o Sets up the Server software configuration 

o Reads the server product configuration file ( <node>xxx . CFG) 
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BUFFERS 

POOL.. (Byte/Block Pool) 
o Located In GEN 

o Contains data structures for DECnet 

- Logical Link Tables 
Adjacency Database 

- Object blocks 
Alias lists 

- Remote name blocks 

- Node counters 

- Minhop/Mincos t vectors 

o Contains databases that do not need to be accessed by the UNA 
directly 

NTPOOL (Network Pool) 

o SBPOOL - subpartition name of NTPOOL 

o Contains the DECnet Buffers 

- Large Data Buffers (LDBs) 
Small Data Buffers (SDBs) 

o Can be accessed by the UNA using 18-bit addressing (resides 
below 124 K) 

SDB (Small Data Buffers) 

o Used for protocol or task control messages 

o Obtained from NTPOOL 

LDB (Large/Receive Data Buffers) 

o "System Buffers" for data communication over the network 

o Each LDB is pointed to by a corresponding CCB 
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CCB (Communication Control Blocks) 
o Obtained from available space in CEXPAR or DSR 
o Used for Interprocess communication 
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Figure 4 Integration of Server Base Components 



18 



INTERNALS 



COMMUNICATIONS SERVER DATA STRUCTURES 



Communications Executive Common Database (CEXCM) 



The CEXCM database: 

o Contains information and pointers to all of the data 
structures important to the Communications Executive (CEX) and 
the various network components. 

o Resides in the CEX. 

o Actual initialization occurs during the network management 
"SET SYSTEM ALL" command. 

Some important pointers found in CEXCM are: 

o $PDVTA 

Pointer to the Process Descriptor Vector Table. 
This table contains an index for all of the DECnet 
processes specified. 
- Each entry (index) points to a Process Descriptor Vector ' 
(PDV) for the process. 
The PDV contains: 

Pointers to the process' dispatch table 

Pointers to the process' database 

The name of the process in radix 50 



o $SLTMA 

Pointer to the System Line Vector Table. 

This table contains pointers to the System Line Tables 
(SLT) set up for each physical line. 

- Each entry points to an SLT for the line. 

- The SLT is used between a DLC and a corresponding DDM. 

- The SLT contains pointers to: 

DDM Line Table 
DLC Line Table 



o $LLCTA 

- Pointer to the Reverse Mapping Table. 

- The Reverse Mapping Table contains the correspondence 
between an LLC (eg. XPT) and its channel. 
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Figure 6 Ethernet Configuration Utilizing the Router Server 
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DECnet ROUTER SOFTWARE 



o Server Base 

o Router specific code 

o System image is down-line loaded from an Ethernet host 

o Network Management functions are performed from the Host node 

o No SYS6EN or NET6EN necessary 

o Network fine tuning is done by modifying the configuration 
files 

o Up-line dump to the loading host in the event of a system 
crash 



MAJOR COMPONENTS (as distributed) 

o Router system image to be down-line loaded 

o Configuration files for tuning 

Server Base Configuration File (<node-id>SB.CFG) 
Router Configuration File ( <node-id>RTR. CFG) 
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Figure 7 DECnet Router System Image 
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INTERNALS 



DECnet Router Major Tasks and Processes 



o RCP1.. (Routing Control Processor) 

Maintains the routing, forwarding, and adjacency databases 

- Monitors circuits for down-line loading, up-line dumping, 
and circuit loopback tests 

o SPI... 

- Server Product Initializing task 

Reads the <node>RTR. CFG file on the host 
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m?PnAt Router System Image Comparison 
Figure 8 Server Base and DECnet router 
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Figure 9 Integration of DECnet Router Server Components 
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Figure 10 General Data Flow for the DECnet Router Server 
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MAJOR DATA STRUCTURES 
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Figure 11 Routing Database 
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Figure 12 ECL Database (Server Base — not specific to 
Router ) 
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APPENDIX A 
PAM SEGMENT DESCRIPTORS 



o Command Segment Descriptor 

o Status Segment Descriptor 

o Receive Segment Descriptor 

o .Transmit Segment Descriptor 

o Free Segment Descriptor 
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PAM SEGMENT DESCRIPTORS 



Command Segment Descriptor 



+ + 

| Opcode | Byte 

+ + 

| Own | Status | Byte 1 

+ + 

| Reserved | T/R | Line # | Byte 2 
+ + 

I | Byte 3 

+ + 

| | Byte 4 

+ + 

I | Byte 5 

+ + 

I I Byte 6 

+ + 

I | Byte 7 



o Byte - Type of command 

o Byte 1 - Indicates ownership of the command descriptor; 1 - 
PAM ownership and » CS ownership (bit 7) 
- Contains the status returned by the PAM upon 
completion of a command (bit 0:6) 



o Byte 2 - Reserved (bit 7:5) 

- Transmit or receive indicator (bit 4). Transmit - 
0, Receive » 1 

- Indicates the particular line for the operation 
(bit 3:0) 



o Byte 3:7 - Used for command specific information (refer to 
Protocl Assist Module Functional Specification for 
more details on specific command information) 
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PAM SEGMENT DESCRIPTORS 



Status Segment Descriptor 



+ + 

| Opcode | Byte 

+ + 

| Own | Reserved | Byte 1 

+ + 

(Reserved | T/R | Line # | Byte 2 
+ + 

I I Byte 3 

+ + 

| | Byte 4 

+ + 

I I Byte 5 

+ + 

| | Byte 6 

+ + 

I I Byte 7 

+ + 



o Byte - Indicates the type of operation 

o Byte 1 - Indcates ownership of the status descriptor 

- Indicates the reason that PAM was trying to obtain a 
free segment or the reason for halting transmission 

o Byte 2 - Line number for the operation 

o Byte 3:7 - Status dependent information 



A- 3 



PAM SEGMENT DESCRIPTORS 



Receive Segment Descriptor 



+ + 

| Haddr | Byte 

+ + 

| Own | Status | Byte 1 

+ + 

| Lo Laddr/Lo ID | Byte 2 

+ + 

| Hi Laddr/Hi ID | Byte 3 

+ + 

| Lo Scount | Byte 4 

+ + 

| Reserved | HI Scount | Byte 5 
+ + 

| Lo Bcount | Byte 6 

+ + 

| Reserved | Hi Bcount | Byte 7 
+ . + 



o Byte - High order 6 address bits of the pointer to the 
receive segment 

o Byte 1 - Indicates ownership of the segment (PAM or the CS) 
(bit 7) 

- Completion status of the segment (bit 6:0) 

o Byte 2 - Low order 8 bits of the pointer to the receive 
segment 

o Byte 3 - Middle 8 bits of the pointer to the receive segment 

o Byte 4 - Segment byte count. The low order 8 bits of an 11 
bit number indicating the length in bytes of the 
segment pointed to in the descriptor 

o Byte 5 - Reserved (bit 7:3) 

- The high 3 bits of the byte count (bit 0:2) 

o Byte 6 - Byte count. Low order 8 bits of the length in bytes 
of the received data in this segment 

o Byte 7 - Reserved (bit 7:3) 

- The high order 3 bits of the length in bytes of the 
received data (bit 2:0) 
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PAM SEGMENT DESCRIPTORS 



Transmit Segment Descriptor 
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o Byte - High order 6 address bits of the pointer to the 
transmit segment 

o Byte 1 - Ownership 

- The completion status of the segment 

o Byte 2 - Low order 8 address bits of a pointer to the transmit 
segment 

o Byte 3 - Middle 8 address bits of a pointer to the transmit 
segment 

o Byte 4 - Segment byte count 

o Byte 5 - Transmit start of message command. Indicates the 
action that the PAM takes when beginning to transmit 
this segment (bit 7:4) 

- Reserved (bit 3) 

- Segment byte count 

o Byte 6 - Byte count. Low order 8 bits of the length in bytes 
of the transmitted data in this segment 

o Byte 7 - Transmit end of message command. This field 
indicates the action that the PAM takes when 
finished with the transmission of this message 
-Byte count. High order three bits of the length of 
the transmitted data in this segment 
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PAM SEGMENT DESCRIPTORS 



Free Segment Descriptor Block 



+ + 

| Haddr | Byte 

+ + 

| Own | Reserved | Byte 1 

+ + 

| Lo Laddr | Byte 2 

+ + 

| Hi Laddr | Byte 3 

+ , — + 

| Lo Scount | Byte 4 

+ — . + 

| Hi Scount | Byte 5 

+ + 

| Reserved | Byte 6 

+ + 

| Reserved | Byte 7 

+~ + 



o Byte - High order 6 address bits of the pointer to the 
free segment 

o Byte 1 - Indicates owner of the descriptor (bit 7) 
- Reserved (bit 6:0) 

o Byte 2 - Low order 8 address bits of the pointer to the free 
segment 

o Byte 3 - Middle 8 address bits of the pointer to the free 
segment 

o Byte 4 - Segment byte count. Low order 8 bits of the length 
in bytes of the segment pointed to in the descriptor 

o Byte 5 - Segment byte count. High order 3 bits of the length 
in bytes of the segment pointed to in the descriptor 
(bit 2:0) 

o Byte 6:7 - Reserved 
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APPENDIX B 
DBCNET DATA STRUCTURES 



o CEX Common Database (CEXCM) 

o Process Descriptor Vector 

o System Line Table 

o DDM Line Table 

o Physical Link Descriptor 

o XPT Database 

o Adjacency Database 1+2 

o Minhop/Mincos t Vector 

o Reachability and Output Adjacency Table 

o Reverse Mapping Table 

o Communication Control Block (CCB) 

o ECL Database 

o Mailbox 

o Window Block 

o Logical Link Table 



B-l 



DECNET DATA STRUCTURES 



DECnet Structure: Communications Executive Common Database (CEXCM) 
Total Number: 1 
Allocated from: CEX 

Use: Contains pointers to pertinent data structures 
for the CEX and network components. 



SPOVTA 
ISLTMA 
SILCT* 
SPOVNP 
tSLTN* 
SCCfiNP 
SCCBSZ 
SR06NP 
SftOBSZ 
IS08NK 
SSOBSZ 
fCCBCT 
fCCBAF 
S106AP 
JCCBAl 
SfiOETh 
$C«POV 
AZTZME 



ACMPft* 



POV vector Table Addreee 



SLT Vector Table Addreee 



ftevorae opting Table Addreia 



Number cf PCVe 



Number ef S»itw Line* 



Number df CC3*i Allocated 



Site of CCB in fytei 



Number ef RC3 # a Allocated 
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Number ef SCS't Allocated 



Slxt df SOB in tytet 



dumber cf CCB't net in Pool 
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Nunc or cf t»C9 Alloc 'alluree 
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DECNET DATA STRUCTURES 



DECnet Structure: Process Descriptor Vector (PDV) 

Size (bytes): 16. plus 2. per channel 

Total Number: 1 per process 

Allocated from: CEX 

Pointed to by: CEXCM - $PDVTA 

Use: Communication process description 



SPDVTB 



$PDVNM 



Z.SCH 



LLCPVD ADDRESS 



DLC PVD ADDRESS 



DDM PVD ADDRESS 



PROCESS RELOCATION BIAS 


Z.DSP" 


DISPATCH TABLE VIRTUAL ADDRESS 




PROCESS NAME (RAD50) 


Z.NAM 


PRIORITY 


^CHANNELS 


Z.LLN 


FLAG WORD 


Z.FLG 


PCB ADDRESS IF LOADED 


Z.PCB 


PTR TO 1ST FREE BLOCK-PROCESS 


Z.AVL 


LLC DATA BASE VIRTUAL ADDRESS 


Z.DAP 


CHANNEL CIRCUIT ID 


Z.MAP 


CHANNEL N CIRCUIT ID 





Z.SCH 



PROCESS RELOCATION BIAS 



DISPATCH TABLE VIRTUAL ADDRESS 



PROCESS NAME (RAD 50) 



PRIORITY 



UNUSED 



FLAG WORD 



PCB ADDRESS IF LOADED 



PROCESS FREE SPACE POINTER 



Z.DSP 



Z.NAM 

Z.LLN 

Z.FLG 

Z.PCB 

Z.AVL 
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DECNET DATA STRUCTURES 



DECnet Structure: System Line Table (SLT) 
Size (bytes): 18. plus 4 per tributary 
Total Number: 1 entry per physical line 
Allocated from: CEX 
Pointed to by: CEXCM - $SLTMA 

Use: Interprocess interface for the communication 
channel 



$SLTME 


ADDRESS OF SLT 










ADDRESS OF SLT 1 














ETC. 








• • • 


















FLAGS- WORD 


L.FLG-* 1 




L.DLC 


DLCPDV INDEX 


DDM PDV INDEX 


L.DDM 




DCM LINE TABLE ADDRESS 


L.DDS 




DLC LINE TABLE BIAS 


L.DLM 




DLC LINE TABLE VIRTUAL ADDRESS 


L.DLS 


L.UNT 


MPX UNIT# 


CONTROLLER # 


L.CTL 


L.COST 


LINE COST 


# STATIONS 


L.NSTA 




CONTROLLER REQUEST BLOCK ADDR 


L.KRBA 


L.OWNR 


LINE OWNER 


MNGMT STATE 


L.NMST 


S.COST 


TRIT. COST 


TRIT. FLAGS 


S.FLG 


S.OWNR 


TRIB. OWNER 


MNGMT STATE 


S.NMST 




ETC. 


ETC. 


• • • 




SLT 1 ENTRY 






«< 




• • • 






ETC. 






• • • 
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DECNET DATA STRUCTURES 



DECnet Structure: DDM Line Table 
Size (bytes): Varies 
Total Number: 

Allocated from: Process space 
Pointed to by: SLT - L.DDS 

Use: Communication Device specific data, interrupt 
linkage code 



VECTOR 



SPACE 


ICB 


ICB POINTER 




MOV@#KISAR5,-(SP) 








PS 




• 

• 






• 
• 






JMP @#LINETBL-ADDR 









.INT 
.PRI 



.DVCHA 



DCM LINE TABLE 



JSR R5JSR 




< 


.WORD XXX 
• 




• 

DATA 

• 
• 




CHARACTERISTICS WD.O 




CHARACTERISTICS WD.1 




• 
• 
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DECNET DATA STRUCTURES 



DECnet Structure: Physical Link Descriptor (PLD) 
Size (bytes): 28. 

Total Number: 1 per physical line 
Allocated from: DSR 

Pointed to by: XPT Database (N$PLD) 
Use: used by XPT to control/monitor each physical 
connection to an adjacent node 



P$TYP 
P$RTIM 
P$CNT 



ADJ. NODE TYPE 



RECOVERY TIMER 



# MSG'S QUEUED 



LINK STATE 



RECOVERY FLAGS 



XPT CHANNEL # 



PENDING CONTROL FUNCTION QUEUE 



GENERAL PROTOCOL TIMER 



FLAGS 



RESERVED 



INPUT PKT. LIMITER 



MAX. DELAY FOR ROUTING MSG. LEVEL'1 



RESERVED 



RESERVED 



LEVEL 1 STATE 



TRANSPORT BLOCK SIZE 



COUNT OF ADJ. NODES OF LOW TSIZ 



STORE AND FORWARD QUEUE 
DOUBLEWORD LISTHEAD 



TRANSPORT COUNTER BLOCK ADDRESS 



16 BIT ADDRESS OF DESIGNATED ROUTER 



DATA LINK MAPPING PACKET SIZE 



INPUT REASSEMBLY QUEUE 



OUTPUT SEGMENTATION QUEUE 



HOLDING AREA FOR INIT. SEED 
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P$TIM 

P$FLG 

P$IPL 

P$RMX1 

P$STA1 
P$TSIZ 
P$TSCT 
P$FWD 

P$CTR 

P$DRTR 

P$PKSE 
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P$OCCB 

PSSEED 
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DECNET DATA STRUCTURES 



DECnet Structure: XPT Database 

Size (bytes): 70. 

Total Number: 1 

Allocated from: DSR 

Pointed to by: XPT PDV - Z • DAT 

Use: Contains pointers to data shared by the XPT 
process and the routing task (RCP). 



TCB ADDRESS OF LEVEL 1 ROUTER 
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LEVEL 1 ROUTING MESSAGE 
DOUBLEWORO LISTHEAD 




NSLV1 


RESERVED 






RESERVED 






RESERVED 


LEVEL 1 ROUTING TIMER 
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PHYSICAL LINK BLOCK VECTOR SIZE 
PHYSICAL LINK BLOCK VECTOR ADDRESS 




N$PLD 




REACHABILITY VECTOR SIZE 
REACHABILITY VECTOR BIAS 
REACHABILITY VECTOR ADDRESS 








RESERVED 








MIN HOP/COST VECTOR SIZE 
BIAS 
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NSMHC1 




RESERVED 








Nl CACHE SIZE 
Nl CACHE ADDRESS 




NSCACH 












BIAS OF ADJACENCY DATA BASE 1 


NSADJ1 


BIAS OF ADJACENCY DATABASE 2 


NSADJ2 


BROADCAST ROUTER PRIORITY TABLE ADDR. 


NSPRI 


^NUMBER OF TRANSPORT LINE COUNTER BLOCKS 
TRANSPORT LINE COUNTER ADDRESS ' 


N$TLC 


• 
• 
• 






TRANSPORT NODE COUNTER SIZE 
TRANSPORT NODE COUNTERS ADDRESS 




NSTNC 
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DBCNET DATA STRUCTURES 



DEC net Structure: Adjacency Database 1+2 

Size (bytes): 4. per entry in each database 

Total Number: 1 entry in each database per adjacent node 

Allocated from: POOL.. 

Pointed to by: XPT Database - N$ADJ1, N$ADJ2 

Use: Contains information about each adjacent neighbor 



NODE ID OF ADJACENCY 



A$CIR 



CHANNEL NO. 



NODE TYPE 



A$NIO 
A$TYP 



ENTRY NUMBER 2 



ENTRY NUMBER N 



A$TYP NODE TYPE FLAG DEFINITIONS 



7 


6 


5 


4 


3 


2 


1 






















L RESERVED 
L- ATSLV1 - LEVEL 1 ROUTING NODE 
L— RESERVED 
ATSUP - NODE 'UP' OR BROADCAST CHANNEL 
L- ATSAUP - ADJACENCY COMING UP 
ATSADN - ADJACENCY GOING DOWN 
— ATSACL - ADJACENCY IS TO BE CLEANED UP BY RCP 
ATSNEX . ROUTER TASK SYNCHRONIZATION FLAG FOR ADJACENCY CLEAN UP 



BLOCK SIZE 



A$TM 



LISTEN TIMER 



INIT. LIS. TIMER 



ENTRY NUMBER 2 



A$TSZ 
A$TMI 



ENTRY NUMBER N 
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DECNET DATA STRUCTURES 



DECnet Structure: Minhop/Mincos t Table 

Size (bytes): 2. per entry 

Total Number: 1. 

Allocated from: POOL.. 

Pointed to by: XPT Database - N$MHC1 

Use: Each entry contains the minimum hops and cost along 
a path to a target node. 



RESERVED 
ENTRY FOR NODE 1 
ENTRY FOR NODE 2 



ENTRY FOR NODE N 



HOPS 



COST 



5 BITS 
RESERVED 



10 BITS 
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DECNET DATA STRUCTURES 



DECnet Structure; Reachability and Output Adjacency Table 
Size (bytes): 2. per entry 

Total Number: 1. entry for each node in the network 
Allocated from: Process space 
Pointed to by: XPT Database - N$R0A1 

Use: Each entry contains an adjacency address if the target 
node is reachable and a if not reachable 



Reserve at . 

w 

■ 





B-10 



DECNET DATA STRUCTURES 



DECnet Structure: Reverse Mapping Table 
Size (bytes): 2. per entry 

Total Number: 1. entry for each XPT channel 

Allocated from: DSR 

Pointed to by: Indexed by SLN 

Use: Maps from an LLC channel to a specific physical line 



1LLCT» 



LLC 


Xndes 


1 C*»rnel » 


Non-«ultidreo 


LLC 


Xnde* 


t Channel • 


Xon-xultidrop 


«tc. 




1 fte. 


Non-»ultidreo 


1 1 


<Stttior 


Tetele £edreflt>/2 


Multidrop 


1 1 


<Stf tior 


Teele *ddrttt>/2 


Multidrop 


«te. 


*til*idrc© 


LLC 


loot* 


t Channel « 


Men* Mult ldreo 


5tc. 




i 5tc. 


Moir- Multidrop 


Etc. 


•nd so en 
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DECNET DATA STRUCTURES 



DECnet Structures Communication Control Block (CCB) 
Size (bytes): 38. 

Total Number: Allocated dynamically 
Allocated from: DSR 
Pointed to by: CEXCM - $CCBLH 
Use: Interprocess communication 



C.BID 

C.STA 
C.MOD 



UNIBUS RUN MASK (M+ ONLY) 


LINK TO NEXT CCE 




BUFFER ID 


RESERVED 


NSP RESERVED CALL 


STATION # 


LINE # 


FUNC CODE MOD 


FUNCTION CODE 


STATUS WORD 


FIRST BUFFER ADDRESS 


DOUBLEWORD 




FIRST BUFFER COUNT 


FIRST BUFFER FLAGS 


SECOND BUFFER ADDRESS 


DOUBLEWORD 




SECOND BUFFER COUNT 


SECOND BUFFER FLAGS 


LLC SPECIFIC 




(4 WORDS) 









C.UPM 

C.LNK - 

C.RSV 

C.NSP 

CLIN 

C.FNC 

C.STS 

C.BUF1 

C.CNT1 
C.FLG1 
C.BUF2 

C.CNT2 
C.FLG2 



LINK TO NEXT CCB (LAST=0) 



BODY OF CCB 
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DECNET DATA STRUCTURES 



DECnet Structure: ECL Database 

Size (bytes): 46. 

Total Number: 1. 

Allocated from: DSR 

Pointed to by: ECL PDV - Z • DAT 

Use: Contains data shared between the ECL process and NETACP 



N$FLG 



NSHIGH 



N$GTI 



NETWORK ACP CCB QUEUE 
DOUBLEWORD LISTHEAD 



FLAGS BYTE 



TIMER COUNT 



FUNCTION CODE 



DUMMY VCB 



SOURCE NODE ADDRESS 



(RESERVED) 



ROUND TRIP DELAY 



SOURCE LINK ADDRESS 



DESTINATION LINK ADDRESS 



ERROR CODE 



MAPPING OF CURRENT LLT 



CURRENT LLT VIRTUAL ADDRESS 



CURRENT LLT PHYSICAL ADDRESS 



MAX ACT LOG LINKS 



CUR ACT LOG LINKS 



COUNT OF CI'S IGNORED DUE TO RESOURCES 



LOGICAL LINK TABLE LENGTH 
LOGICAL LINK TABLE ADDRESS 



ECL NODE COUNTERS 

DOUBLEWORD LISTHEAD 

ECL MODE COUNTERS APR BIAS 



MAILBOX QUEUE LISTHEAD 



GENERAL DELIVERY CCB QUEUE LISTHEAD 



GEN DEL INI TIMER 



GEN DEL CUR TIMER 



N$ACQ 

NSTIM 

NSFNC 

N$VCB 

N$SNOD 

N$DLY 

N$SLA 

N$DLA 

NSERRC 

N$LLTM 

N$LLT 

N$PLLT 

N$ACTL 

N$CIR 

N$VLC 

N$ENC 



N$MBXQ 
NSGENQ 
N$GTM 
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DECNET DATA STRUCTURES 



DECnet Structure: Mailbox 
Size (bytes): 16. 

Total Number: 1. per active network task 
Allocated from: DSR 

Pointed to by: Window Block - W.MBOX, Task Header - H. 
Use: Controls the tasks' overall network access 



M.N AST 
M.MAX 



[RESERVED FOR RSX) 



LINK TO NEXT MAILBOX 



POINTER TO TASK TCB 



# OF AST ENT 



MAX # OF LLS 



(RESERVED) 



#OF ACT LLS 



USER NETWORK DATA AST ADDRESS 



NETWORK DATA LISTHEAD 



LINK RECOVERY TIMER 



M.NEXT 
M.TASK 

M.USE 
M.SPA 
M.MAI L 
M.RESP 







LINK TO NEXT MAILBOX 




BODY OF THE MAILBOX 










LAST MAILBOX IN LIST (0) 


> 


BODY OF THE MAILBOX 
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DECNET DATA STRUCTURES 



DECnet Structure: Window Block 
Size (bytes): 40. 

Total Number: 1. per logical link 
Allocated from: DSR 

Pointed to by: User Link Ad j£ l ^ r estab iished logical 
Use: Data transmission and reception over 

link. 



(RESERVED FOR RSX) 


W.CTL 


TASK LUN 


LINK STATUS 


W.STAT 


POINTER TO ASSOCIATED LLT 


W.LLT 


SEGMENT SIZE 


W.SEGZ 


TEMPORARY WORKSPACE 


W.TMP 


POINTER TO MAILBOX 


W.MBOX 


(RESERVED) 


KN1 AST STATUS 


W.KAST 


TRANSMIT QUEUE LISTHEAD 


W.SNDC 


POINTER TO CURRENT XMT I/O PKT 


W.CSND 


POINTER TO CURRENT INT I/O PKT 


W.CINT 


RECEIVE QUEUE LISTHEAD 


W.RCVC 
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DECNET DATA STRUCTURES 



DECnet Structure: Logical Link Table (LLT) 
Size (bytes) : 42. - 62. 
Total Number: 1. per logical link 
Allocated from: DSR 

Pointed to by: Logical Link Address Table 

Use: Contains the source and destination logical link address 



L.TYP 


LINK TYPE 


LINK STATE 


L.STA 




LOCAL LOGICAL LINK ADDRESS 


L.LLA 




REMOTE LOGICAL LINK ADDRESS 


L.RLA 




REMOTE NODE 16 BIT ADDRESS 


L.REM 


L.TIPD 


# DATA XMTS IN PROG. 


# l/LS XMTS IN PROG. 


LTIPI 


L.VER 


REMOTE NSP VERSION 


LINK FLAGS 


L.FLAG 




NEXT DATA SEGMENT NUMBER TO BE ASSIGNED 


L.NXN 




NEXT l/LS SEGMENT NUMBER TO BE ASSIGNED 


L.NIN 




NEXT DATA SEGMENT NUMBER TO BE. RECEIVED 


L.RNO 




HIGHEST ACK # FROM USER ON DATA CHAN 


L.USA 




NEXT l/LS SEGMENT NUMBER TO BE RECEIVED 


L.LNO 




HIGHEST l/LS ACK # FROM USER 


L.LSA 




LAST DATA SEGMENT NUMBER ACK'D 


L.LDA 




LAST INT/LS SEGMENT NUMBER ACK'D 


L.LIA 


L.CSTA 


NET DISC SUBSTATE 


USER DISC SUBSTATE 


L.USTA 




POINTER TO USER'S WINDOW BLOCK 


L.WIND 


L.TIC 


INTERRUPT COUNT 


TRANSMIT COUNT 


L.TC 




FLOW CONTROL REQUEST COUNT (l/LS) 


L.LSFI 




FLOW CONTROL REQUEST COUNT (DATA) 


L.LSFD 




REMOTE FLOW CONTROL COUNT ESTIMATE 


L.RCF 




l/LS PENDING ACK QUEUE 


L.ILSQ 


L.RTYD 


RETRY CELL (DATA) 


TIMER CELL (DATA) 


L.TMRD 


L.RTYI 


RETRY CELL (l/LS) 


TIMER CELL (l/LS) 


L.TMRI 




MESSAGE AWAITING RETRANSMISSION 


L.RTQ 




LONG TERM TIMER 


L.LIT 
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DECNET DATA STRUCTURES 
DECnet Structure: Logical Link Table (continued) 



L.LPT 



L.MAST 



L.OPD 



PERIODIC TIMER 


TIMER (SECONDS) 


INITIAL LONG TERM TIMER 


MESSAGE RE-ASSEMBLY QUEUE 


RE-ASS. QUEUE TMR. 


SIZE OF RE-ASS. QUEUE 


POINTER TO ECL COUNTER BLOCK 


SEGMENT SIZE FOR THIS LINK 


DISCONNECT REASON CODE 


OPTIONAL DATA 


OPTIONAL DATA LEN. 


(16-BYTES) 




(RESERVED) 





LSEC 
L.ILTT 
L.MASQ 
LMASZ 

L.CTR 
L.SEGZ 
L.DCR 
L.OPDL 



THE FOLLOWING ADDITIONAL FIELDS ARE ONLY INCLUDED IF 
SYSTEM LEVEL INTERFACE (SLI) IS PRESENT. 



L.ULA 
L.PDVD 



USER LINK ADDRESS 



SOURCE CHANNEL # 



DATA PROCESS PDV CONTROL PROCESS PDV 



TRANSMIT MESSAGE QUEUE DOUBLEWORD 
LISTHEAD 



CURRENT TRANSMIT CCB ADDRESS 



INTERRUPT MESSAGE TRANSMIT QUEUE 
DOUBLEWORD LISTHEAD 



CURRENT INTERRUPT CCB ADDRESS 



PENDING CONTROL CCB ADDRESS 



PENDING ACCEPT CCB ADDRESS 



L.CHN 

L.PDVC 

L.XMTQ 

L.CXMT 
L.INTQ 

L.CINT 
L.PCTL 
L.ACC 
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Node Troubleshooting 



INTRODUCTION 



A number of troubleshooting tools are available for dealing 
with Communications Server problems. This chapter describes the 
tools that may be used to verify that the server is working 
properly and to analyze any problems that occur. The available 
tools include: 

o Diagnostic Tools 

Server Self Test 

Loadable Diagnostic Image (LDI) 

o Network Management Facilities 

- Loopback tests 
Examining Error Counters 

- Network Event Logging 

- Remote Console Facility 

o On-line Debugging Tool (POD) 
o Crash Dump Analysis 

Some problems require more sophisticated procedures such as 
analyzing crash dumps or tracing through listings to retrieve 
specific information which may not be documented. 

REFERENCES 

RSX DECnet System Manager's Guide 
DECnet VAX System Manager's Guide 

Ethernet Communications Server Operations and Maintenance Manual 
DECnet Router Installation and Operation Guide 
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Node Troubleshooting 

DIAGNOSTIC TOOLS 

To check the server hardware components, run the following 
diagnostic tests: 

o Self Tests 

o Loadable Diagnostic Image (LDI) 
o On-line Tests 

These diagnostics are Installed at the same time as the 
server software and reside 

o On the host node where the server software was originally 
installed • 

o On any host node to which the server software was copied after 
installation • 

Self Tests 

The server self tests are stored in ROM and are executed: 
o At power up of the server 

o By depressing the START button on the server 
o Through NCP commands at the host, eg. 

NCP>LOAD NODE ROUTER 
or 

NCP>TRI66ER NODE ROUTER 
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Node Troubleshooting 



To load and run the diagnostics, the user must be sure that: 
o The server is connected to the Ethernet* 
o A host node is running and connected to the Ethernet. 



NOTE 

If either of these conditions is not met, then the 
server will Halt with an _02 LED display and wait. 

The self tests do a complete check of the path over which the 
software is to be transferred, from the host node to the server 
(load path) for the: 

o CPU 

o Memory 

o CBT 

o DEUNA 

o Ethernet 

o Cursory check of the PAM(s) 



Self Test Versions 



There are two versions of the self tests: long and short. 

o Long Self Test : 

TEST button is pressed in 

Tests the entire 512KB of memory 

CBT display blinks at a slower rate, indicating the long 
version of the testing procedure 

Displays the 48 bit Ethernet address of the server 

- 4 minute runtime 

- On completion, requests the LDI 
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Node Troubleshooting 



o Short Self Test: 

- TEST button out 

Tests only the first 32KB of memory 
Cursory check of the rest of memory 
On completion, requests the server software image 



Errors found during any portion of the diagnostic tests are 
reported by means of fault lamps and digital displays located on 
the server. The fault indicators when lit show which of the 
components is at fault: a line card, logic board, or Ethernet 
cable. The digital display identifies the faulty module (FRU). 
Figure 1 shows where these Indicators are located and Table 1 
lists the indications a user will see if the server has an error. 









Off On 






UmMU#i bote 

o o o 


0000 


Tart 



start nrS^ H 


tawar Run 

o o 













Figure 1 Communications Server Fault Indicators 
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Node Troubleshooting 
Table 1 Testing and Diagnostics Error Indications 



PANEL INDICATION TYPE 


STATE 


COMMENTS 


Fault Light 


ON 


Line Card, Logic, or Cable Fault 


Run Light 


OFF 


CPU Halted 


Cyclic Pattern Display 


OFF 


Software not Working * 


Line Card Light 


ON 


Line Card(s) Faulty (or not in use)** 



NOTE 

* This assumes that the server software was 
previously running. 

** Line card lights are only valid when running 
the line card diagnostics* 
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Node Troubleshooting 



Table 2 Self Test Indications 



Indicator 


Color 


While Test 
is Running 




After Test 
is Complete 


Line Card Fault 


Red 


Blinks 




Off 


Logic Fault 


Red 


Blinks 




* 


Cable Fault 


Red 


Blinks 




Off 


Segment Display 1 


Red 


Blinking 


8. 


Underscore 


Segment Display 2 


Red 


Blinking 


8. 


Underscore 


Segment Display 3 


Red 


Blinking 


8. 





Segment Display 4 


Red 


Blinking 


8. 


2 


Test 


Red 


Blinks 




Off 


Start 


Red 


On 




On 


Power 


Green 


On 




On 


Run 


Green 


On 




Off 


Line Card Light(s) 


Red 


On 




On 



NOTE 

Blinking rates are 1 per second. Line card lights 
are located on each line card. The self test does 
not check any of the PAM line cards* 

* This fault light will be on after completion of 
the self test and the server is not connected 
to the Ethernet. If the server is connected to 
the Ethernet, this light should be off at the 
completion of the self test. 



Upon completion of the tests, a request of an "image" is made 
to the host. The image that is loaded will be either the Loadable 
Diagnostic Image (LDI), or the Router server software image 
depending on the TEST button setting. 
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* 

Fmdt 

UnaCaralUaJa CaMa 

O <* 3 

OUrfcjng 
1 #-U 

Figure 2 Front Panel Display During Self Test 





Um Cart Laaja dm 

o o o 



I L 



3 34 



Tatt Start 

60 51 




Faatt 



Una Card Loala Cable 

o o o 



d£5h 



O-NotUt 



Off Om Loak 



Tart Start 

SI 6B 




VJ 



Km 



Figure 3 Ethernet Address Display (3 parts) 
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Node Troubleshooting 
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Figure 4 Example of a Logic Fault During Self Test 
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Figure 5 Example of a Cable Fault During Self test 
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Node Troubleshooting 



Loadable Diagnostic Image (LDI) 

The LDI is loaded and started if the "Test" button on the 
front panel is pressed to the in position. This image is 
down-line loaded over the Ethernet to the server. Results of LDI 
tests show on the LED display on the front panel of the server. 
The LDI runs dignostics on the PAM, Line cards, and CBT. 

NOTE 

The results of the LDI can also be displayed on a 
host console using the Console Carrier facility. 



An integral part of the LDI is the SYSEXE (System Exerciser). 
This program, which automatically runs after the other diagnostics 
have completed, is designed to test the server in a manner close 
to actual use. Its main objective is to create a stressful 
situation by establishing communications between the server 
modules at very high data rates. 

SYSEXE tests the following components: 

o The PDP-11 UNIBUS to ensure proper data transfers 

o PAM(s) for proper service to the line cards 

o The line cards (up to 16) for proper data transfers 

o The DEUNA is put into loopback mode and packets are checked 
for proper transfer from UNIBUS memory to and through the 
DEUNA 
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Figure 6 Front Panel Display During Loading of LDI 
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Figure 7 No Fault Display During LDI 



»aatt 




Off 


Oi 




tMfe 




UmCaftfUaja Casta 

• o o 


i nn 

* -U i 


T«t Start 

s s 

























Figure 8 Line Card Fault Display During LDI 
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Network Management Facilities 



The server provides standard NCP capabilities allowing a user 
to perform a variety of network management functions. 

NETWORK CONTROL PROGRAM (NCP) 



Table 3 NCP Troubleshooting Functions and Keywords 

NCP Functions Router Server Router/X.25 

Gateway 

CONTROL FUNCTIONS 
/SET/TELL/LOOP 

Remote Command X X 

Execution 

Setting and X X 

Clearing Executor 

Parameters 

Setting and Clear- X X 

ing Passwords 



Event Logging X X 

Loopback X X 

DISPLAYS /SHOW 

Line, Circuit, X X 

and Node 

Information 

System Information X X 

Logging Information X X 
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Table 4 NCP Troubleshooting Functions and Keywords (cont.) 

NCP Functions Router Server Router/X.25 

Gateway 

Counters Information 

Line Counters X X 

Circuit Counters X X 

Node and Executor X X 

Counters 

NODE NAME INFORMATION 
/SET/CLEAR/ZERO 

Changing a Node X X 

Name 
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Node Troubleshooting 



LOOPBACK TESTING 

NCP provides circuit and node level loopback test! 
used to determine: 

o The proper functioning of network components 
o The cause of a communications problem 



that are 




ROUTER 



ETHERNET 




NCP> LOOP NODE ROUTER 
NCP> LOOP CIRCUIT UNA-0 



Figure 9 Circuit and Node Level Loopback Tests 
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Node Troubleshooting 



Node, Circuit and Line Identification 



o A DECnet node Is Identified by a node address, which Is unique 
In the network, and by a name, which Is local to the node 
(executor) • 

o A PSI node is Identified by a 12-character DTE address 
(supplied by the PSN vendor), and by name, which is local to 
the node. The first four characters in the DTE address Is an 
International code for a PSN ( 31 10-TELENET, 2342-PSS, etc). 

o An Ethernet node is Identified by a unique Ethernet Physical 
Address. This address is set by the software at the Ethernet 
node. An Ethernet Physical Address is 48 bits in length and 
represented by six pairs of hexadecimal digits separated by 
hyphens • 

Example 1 AA-00-04-00-3B-04 



o A circuit is the logical path between two adjacent nodes or' 
DTEs . A DECnet circuit is identified by 

Device type-Controller number[-Unit number ][ .Tributary number] 
DMC-1 
DMP-1.3 
UNA-0 
LC-1 



o A line is the physical path between two adjacent nodes. A 
line is identified by: 

Device type-Controller number [ -Uni t number] 
DUP-1 
SDP-1 
UNA-0 
LC-0 
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Node Level Loopback Tests 



Node level loopbacks are used to verify the networking 
capabilities between the server and any other node. These nodes 
may be part of the LAN or remotely connected to the LAN via the 
Router server. A node level loopback is performed by using the 
TELL prefix with the NCP LOOP NODE command or by using NCP to SET 
EXECUTOR to the Router and performing the loopback tests. 



Example 2 NCP>TELL SERVER LOOP NODE MAUDE 



MAUOE 



LOOPBACK MIRROR 



SERVER 



NET. MAN. *0 
ACCESS ROUTINES 0* 



NET. MAN. 
LISTENER 



T 



TT 



~r-i r 

"T 



T 



HAROLD 

i N <y i 



NET. MAN 
ACCESS ROUTINES 



TT 



T 
(?) 



T 



Figure 10 Node Level Loopback 
(NCP>TELL SERVER LOOP NODE MAUDE) 
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Circuit Level Loopback Tests 



Circuit level tests are used to verify either the Ethernet 
circuit or the point-to-point connections between the line cards 
on the Server and a remote node. 



Point-to-Point Circuits: 

These tests verify the point-to-point connection between the 
Router Server and a non-LAN node 



Example 3 NCP>LOOP Circuit LC-1 



Ethernet Circuits: 
These tests verify: 
o the Ethernet cable 

o the interfaces, transceivers, and transceiver cables that 
connect the Server to the Ethernet 



Example 4 NCP>LOOP CIRCUIT UNA-0 
NOTE 

The PHYSICAL ADDRESS needs to be specified on VMS 
hosts . 



A user may specify a single Ethernet node or use the multicast 
address. When the multicast address is used, the first available 
Ethernet host will accept the data and loop it back. 



Example 5 NCP>LOOP CIRCUIT UNA-0 



A loop assist test may also be performed on the Ethernet 
circuits. These tests loop data between two Ethernet nodes, the 
initiating and destination nodes, with the help of a third, 
assistant node. There are three types of loop assist tests: 
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Node Troubleshooting 



Transmit 

- Data is sent from the initiating node to the assistant 
node • 

The assistant relays the data to the destination node. 
The data is sent directly back to the initiating node. 



Receive 

- Data is sent from the initiating node to the destination 
node • 

The data is relayed to the assistant node. 

- The assistant relays the data to the initiating node. 



Full (default) 

- Data is sent from the initiating' node to the assisting 
node • 

The assisting node relays the data to the destination 
node . 

The destination node sends the data back to the assistant 
node • 

The data is sent from the assistant node to the initiating 
node • 



Example 6 NCP>LOOP CIRCUIT UNA-0 NODE SERVER ASSISTANT NODE 
MAUDE HELP FULL 

NOTE 

These tests are useful when the node being tested 
is receiving a signal too weak to respond to. The 
user needs to know the network layout to be sure 
that the assistant node is between the two nodes 
being tested. 
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Figure 11 Loop Assist (Transmit) 
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Figure 12 Loop Assist (Receive) MK\*44»t2 
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Figure 13 Loop Assist (Full) 
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EXAMINING NODE, CIRCUIT, AND LINE COUNTERS 



DECnet software automatically maintains counters for the 
system, lines, circuits, and nodes. These counters are maintained 
by the current Executor and include information such as: 

o The number of data packets sent and received over a line 

o System buffer allocation failures 
o Routing packet information 



These counters can be displayed, zeroed and used along with 
loopback tests to try and locate the source of a network problem. 
The NCP SHOW commands display the various counters. 



Node Counters as of 5-APR-1984 10:15:21 

Executor node * 4.36 (OLEBOY) 

Aged packet loss 

Node unreachable packet loss 

Node out-of-range packet loss 

Oversized packet loss 

Packet format error 

Partial routing update loss 

Verification reject 

Control buffer failures 

Small buffer failures 

Large buffer failures 

Receive buffer failures 



Example 7 Showing Executor (Router) Counters 
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Circuit Counters as of 5-APR-1984 10:16:16 



Circuit - LC-8 



9404 Seconds since last zeroed 

Terminating packets received 

Originating packets sent 

Corruption loss 

7071 Transit packets received 

12926 Transit packets sent 

Transit congestion loss 

Circuit down 

Initialization failure 

243388 Bytes received 

511058 Bytes sent 

7730 Data blocks received 

13899 Data blocks sent 

Data errors inbound 

Data errors outbound 

Remote reply timeouts 

Local reply timeouts 

Remote buffer errors 

Local buffer errors 

Selection Intervals elapsed 

Selection timeouts 



Example 8 Showing Circuit Counter LC-8 on a DECnet Router 
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NETWORK EVENT LOGGING 



The event logging facility records events that occur during 
network operation. The types of network events that are logged 
include : 

o Changes in line, circuit, and node states 

o Lost event reporting (too many events occuring simultaneously 
at the server) 

o Passive loopback (the executor is looping back test messages - 
Router only) 

o Errors in data transmission or in the line cards 



EVENT 
PROCESSOR 



EVENT 
QUEUE 



RAW EVENTS 



EVENT FILTERS 



EVENT 
QUEUE 



EVENT 

TRANSMTITER 



EVENT 
QUEUE 



TO EVENT 
RECEIVERS 



EVENT 

TRANSMITTER 



APPLICATIONS LAYER 



EVENT 
QUEUE 



RAW EVENTS 



SESSION CONTROL LAYER 



EVENT 
QUEUE 



RAW EVENTS 



ENO COMMUNICATIONS LAYER 



EVENT 
QUEUE 



RAW EVENTS 



ROUTING LAYER 



EVENT 
QUEUE 



RAW EVENTS 



DATA LINK LAYER 



EVENT 
QUEUE 



RAW EVENTS 



PHYSICAL LINK LAYER 



EVENT 
QUEUE 



RAW EVENTS 



MKV844M? 



Figure 14 Event Logging Interface 



Node Troubleshooting 
Table 5 lists the supported event classes. 

Table 5 Network Event Classes 



Event Class Source of the Event 

Network Management Layer 

1 Applications Layer 

2 Session Control Layer 

3 End Communications Layer 

4 Routing Layer 

5 Data Link Layer 

6 Physical Link Layer 
224 - 225 Server Base 

226 - 227 DECnet Router 

232 - 233 (Future use by SNA Gateway) 

234 - 255 Reserved for future Server use 
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Example 9 shows some events as they appear on the host system 
console • 



Event type 0.3, Automatic service 
Occurred 8-SEP-83 10:41:27 on node 4.25 (PIPPIN) 
Circuit UNA-0 
Service type » Load 
Status » Requested 

Node * 4.134 (MNCHKN) , File - DLO : [ 100 , 54 ] PLUT02 . SYS 
Software type * Secondary loader 



Event type 0.3, Automatic service 
Occurred 8-SEP-83 10:41:27 on node 4.245 (PIPPIN) 
Circuit UNA-0 
Service type » Load 
Status » Successful 

Node » 4.134 (MNCHKN), Pile » DLO: [ 1 00 , 54 ] PLUT02 . SYS 
Software type - Secondary loader 



Event type 0.3, Automatic service 
Occurred 8-SEP-83 10:41:28 on node 4.245 (PIPPIN) 
Circuit UNA-0 
Service type - Load 
Status = Requested 

Node - 4.134 (MNCHKN), File » DLO : [ 1 00 , 54 ] PLUT03 . SYS 
Software type « Tertiary loader 



Event type 0.3, Automatic service 
Occurred 8-SEP-83 10:41:30 on node 4.245 (PIPPIN) 
Circuit UNA-0 
Service type » Load 
Status » Successful 

Node - 4.134 (MNCHKN), File » DLO : [ 1 00 , 54 ] PLUT03 . SYS 
Software type ■ Tertiary loader 



Event type 0.3, Automatic service 
Occurred 8-SEP-83 10:41:31 on node 4.245 (PIPPIN) 
Circuit UNA-0 
Service type - Load 
Status * Requested 

Node - 4.134 (MNCHKN), File - DL1 : [4 , 4 ] MNCHKN. SYS 
Software type » System 
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Event type 0.3, Automatic service 
Occurred 8-SEP-83 10:42:17 on node 4.245 (PIPPIN) 
Circuit UNA-0 
Service type - Load 
Status * Successful 

Node - 4.134 (MNCHKN) , File - DL1 : [ 4 , 4 JMNCHKN . SYS 
Software type » System 



Event type 4.15, Adjacency up 
Occurred 8-SEP-83 10:42:32 on node 4.245 (PIPPIN) 
Circuit UNA-0 

Adjacent node - 4.134 (MNCHKN) 



Example 9 Event Logging on the Host Console 



Logging Network Events 



Network events generated by the server are logged by default 
onto the logging console on RSX hosts or the logging monitor on 
VMS hosts. If the server's host is not available, the server 
sends the message to the first available node listed in the 
server's backup host list. Logging must be enabled at - any host 
expected to receive a network event from a server. 



NCP>SET LOGGING CONSOLE STATE ON (RSX) 
Example 10 Using NCP to Set the Logging Console (RSX) 



$NCP SET LOGGING MONITOR STATE ON (VMS) 
$ REPLY/ ENABLE*NET 

Example 11 Using NCP to Set the Logging Monitor (VMS) 
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User Options for Logging Events 



The user has a number of options available for logging 
network events. Table 6 shows the logging options available to a 
user • 



Table 6 User Options for Logging Events 



SET r iCNOWN LOGGING ) (EVENTS event-list) [CIRCUIT circuit-idi 
^ LOGGING CONSOLErSKNOWN EVENTS ( <LINE line-id 
ITOR/V* ) ( NODE node-id 



LOGGING CONSOLE!^ KNOWN EVENTS 

CLEAR ) 

I LOGGING MON 



INK NODE node-id 



NCP>SET KNOWN LOGGING KNOWN EVENTS CIRCUIT LC-2 
Example 12 Using NCP to Set Up Network Event Logging 

NOTE 

Successive SET LOGGING commands applied to the 
same component and parameter have a cumulative 
affect. Each SET command issued will add new 
logging functions without overriding any functions 
previously set up. A user must explicitly cancel 
these functions with the CLEAR LOGGING commands. 



The default SINK NODE when not explicitly stated 
is the servers' host or the backup host list. 
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ON-LINE DEBUGGING TOOL (POD) 



The server on-line debugging tool (POD) is an analysis tool 
used to examine: 

o Memory of a running server 

o A server dump image 

o The distribution image of a server product 

For a running server system, POD may be used to make deposits into 
server memory. 

Since the server does not support a console terminal, 
Interactive support tools such as POD must be run on a Host 
system. The POD utility: 

o Runs in cooperation with a server task, Remote Examine and 
Deposit (RED...), when examining the memory of a running 
server . 

o Can only be run by a privileged user since it allows complete 
access to the running server's memory. 

o Is transportable with the ability to run under RSX and VMS 

When diagnosing problems, POD can be used to: 

o Obtain information not provided by event logging or network 
management facilities. This includes examining: 

- Data structures 

- Trace buffers 

- Possibly corrupted code 

o Insert "debug code" in a running server to determine if 
certain points in the code are reached, and to save the 
contents of pertinent data cells if needed. A scratch data 
area exists in the server's executive address space for this 
purpose • 

o Tailor on-line and crash dump analysis report generation and 
allow symbolic, interactive examination of dump images and 
running server systems. 
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o Support command files and a data structure Interpreter that 
allows analysis procedures to be pre-defined. 



NOTE 

Although POD can be used to insert DEBUG code, 
this feature is not intended to be used as a 
"patching mechanism" for the server products. 



POD Help 



run pod 

Pluto On-Line Debusser - '.'3.0.0 
P0D>heiP -J-v.u 

POD, (PLUTO On-Line Debusaer) 



The following is a lis 

* @ 

* BIAS 

* BREAK 

* CONVERT 

* DEFINE 

* DEPOSIT 

* DISPLAY 

* EXAMINE 

* EXIT 

* HELP 

* MAP 

* MONITOR 

* NOBIAS 

* NOMAP 

* SET ADDRESS 

* SET IMAGE 



of available commands: 

* SET LENGTH 

* SET LOG 

* SET OUTPUT 

* SET REGION 

* SET SERVER 

* SET TYPE 

* SHOW IMAGE 

* SHOW LENGTH 

* SHOW LOG 

* SHOW OUTPUT 

* SHOW REGION 

* SHOW SERVER 

* SHOW STRUCTURE 

* SHOW SYMBOL 

* SHOW TYPE 

* UNDEFINE 



POD> 



Example 13 Available Help for POD 
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POD Functions 

POD includes the following functionality: 
o The capability to examine memory locations 
o Make deposits into a running server system 
o Monitor locations 
o Command file support 
o Log file support 

o The capability to def ine/undef ine user symbols 
o Display data structures 

o The ability to crash and reload a server 



POD resides in the host system and is installed on the host 

during server installation. To run POD a user must be privileged 

on RSX or a VMS user must have either OPERATOR or DIAGNOSE 
privileges set. 



POD Contexts 



Before Issuing any commands, a user must specify a set of 
contexts. A context indicates to POD where an examine or deposit 
is to take place. The user must specify the following contexts: 

o Server - identifies the specific product (Router, Router/X.25 
gateway, etc) currently running on the server in 
ques t ion • 

o Image 

- A distribution image of a server product 

- A dump image from a crashed server 

- Memory of a running server (node name if the server is 
running) 
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Region 

- The 22-bit address space in 
the I/O page) 

- The executive address space 
The virtual address space 
DECnet process, etc. 



physical memory only (excludes 

(includes the I/O page) 

of an RSX-11 task, common, 



Example 14 shows a sample POD session setting contexts: 



>RUN POD 

Pluto On-Line Debugger - V3.0.0 
POD>SET SERVER ROUTER 
POD>SET IMAGE NODE-MAUDE 

DECnet Router Server VI. 
POD>SET REGION EXECUTIVE 
POD>SHOW IMAGE 
Current image is node MAUDE 
Access : Examine 
RED protocol version 1. 0. 
Examine buffer size is 256 bytes 
POD> 



Example 14 Sample POD Session Setting Contexts (RSX) 



Node Troubleshooting 



POD Context Commands 



o SET SERVER 

- Looks for a .DSD (Data Structure Definition) file. 

Reads in the name of the directory where the structures 
are found. 

- Opens a . SYM (Symbol) file and loads the system symbol 
table which contains executive symbols. 

These symbols can be used if the region is then set to the 
executive or to a region that is a privileged task. 



o SET IMAGE 

- If the image is a running server node, POD communicates 
with RED... 

If the image is a dump or distribution image, POD attempts 
to open the file. 

POD displays the ID field in the DECnet Home Block to 
Indicate whether the correct symbol (.SYM) file Is being 
used • 



o SET REGION 

POD gets to the correct region, the symbol (.SYM) file for 
that region is read. 



NOTE 

For each SET command, there is a corresponding 
SHOW command (eg. SHOW SERVER, SHOW IMAGE, SHOW 
REGION) . 
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POD Features and Commands 

Command Syntax 

Each POD command has the following format: 

POD>Command [Keyword] [/Qualifier] [Parameter] 

o Command - a verb Indicating the general function to be 
performed 

o Keyword - indicates the specific function to be performed 
o Qualifier - modifies the effect of the command 

o Parameter - qualifies the function in some way (eg. 
specifying a range of locations to be monitored) 

Characters with special meanings (used as part of a qualifier or 
parameter) : 

o @ (contents operator) - requests POD to extract the contents 
of the location previously examined and use this as the next 
address to examine. 

o : (range operator) - specifies a range of addresses for an 
EXAMINE command 

o ! (comment indicator) - indicates that a comment follows 
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Examine 

POD allows a user to display the contents of a specified 
address or range of addresses. The contents of the address can be 
displayed in: 

o Numeric form (decimal, octal, or hexadecimal) 

o ASCII 

o RAD 50 

o Symbols (where possible) 

The examine command may also be used to display formatted 
output as in the display of data structures. 

NOTE 

An EXAMINE range occurs as an atomic operation 
(uninterruptable) on a running server. 

The EXAMINE command may be abbreviated to E. 

All display formats are diplayed as either words 
or bytes, except for RAD50, which is displayed, in 
words only. 
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POD >EX AMINE *LDBRT * 10 



*LDBRT + 10/ 177776 

POD >EXAM INEZ DEC IMAL/RAD50 1001 120 



FE.PKT 


/ 


7250. 


DUJ 


T.RDCT 


/ 


224. 


EX 


T.EFLM 


/ 


908. 


V. 


T.EFLM + 


2/ 


225. 


EY 


T.GGF 


/ 


908. 


V. 


T.LGTH 


/ 


226. 


EZ 


T.LGTH + 


2/ 


908. 


V. 


S*«IEN + 


1/ 


227. 


E* 


S**IEN + 


3/ 


23264. 


NUX 


POD >EX AMINE . 






FE.PKT 


/ 


16122 




T.RDCT 


/ 


340 




T.EFLM 


/ 


1614 




T.EFLM + 


2/ 


341 




T.GGF 


/ 


1614 




T.LGTH 


/ 


342 




T.LGTH + 


2/ 


1614 




S**IEN + 


1/ 


343 ' 




S**IEN + 


3/ 


55340 




POD>E fPARHD 







*PARHD / 111734 

POD>EXA/STRUCTURE*PCB & 



Partition Control Block 
P.LNK * 111670 
Priority * 0. 
10 + IOSB count * 0. 
Partition Name ■ CEXPAR 
P. SUB = 000000 
P. MAIN = 111734 
P.REL = 001120 
P. SIZE = 000060 
Wait Queue = 000000 111754 
Swap Size « 111754 
Busy Flaas = 200 200 
P.TCB = 000000 
Startins APR * 

Common 
P.HDR = 000000 
Protection word ■ 177777 

Attachment Descriptor Listhead * 000000 111772 
POD> 



Example 15 Using the Examine Command 
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Deposit 



The DEPOSIT command allows a user to modify the contents of 
memory locations in a running server image. Deposited values may 
be in : 

o Numeric form 

o ASCII 

o RAD 50 

o Symbolic format 



The DEPOSIT facility is intended only to assist in diagnosing 
problems. Any inserted code should only be temporary. A scratch 
area exists in the server base for depositing Debug code (100 
octal bytes starting at $PATCH) • To use the DEPOSIT command, the* 
/DEPOSIT switch must be specified when Issuing the SET IMAGE 
command • 

There are two modes for deposits: protected and unprotected. 
Protected deposits require that the user EXAMINE the location or 
range of locations before making a deposit. Unprotected deposits 
are made by RED... without any validation of the contents. This 
type of deposit is used when the server system changes the value 
of the desired location before deposits can be made. In this 
case, protected deposits are prevented, and the user is notified. 

The DEPOSIT command can be abbreviated to D. 

NOTE 

The protected mode is the default value for 
deposits. The /UNPROTECT switch changes the 
default, but requires that the user specify the 
/UNPRODEP qualifier be used when issuing the SET 
IMAGE command. 
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POD>EXAMINE SYSPAS + 1 

POD>DEPOSIT/BYTE/ASCII SYSPAS+1 T.E.S.T 



Example 16 Depositing into Server Memory 



RED... stores information on all deposits that have been 
made. To determine if a deposit has been performed use the 
following example: 



POD>SET REGION RED... 
POD >EX AMINE NUMDEP 

NUMDEP / 6 

POD >EX AMINE DEPBAS 

DEPBAS / 1 

POD>EXAMINE DEPADD 

DEPADD / 792 

POD>EXAMINE DEPLEN 

DEPLEN / 14 

POD> 



Where : 

NUMDEP - The number of deposits that have occurred. 

The following contain data about the last deposit only. 

DEPBAS - * Physical Region 
1 ■ Executive Region 

or the base address of the partition 

DEPADD (two words) - address of start of deposit 

DEPLEN - length of the deposit (top bit set 
if unprotected) 



Example 17 Examining RED... for Deposits 
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Monitor 



The MONITOR command allows a user to monitor up to five 
locations during a specified time interval. The MONITOR command 
also indicates any changes in the contents of the location(s). 
The contents of the specified locations are displayed initially, 
and then again if the contents change (the locations are monitored 
periodically not continuously)* This command is allowed on a 
running server system only. 

NOTE 

The default setting for the MONITOR command has 
POD re-examine the locations once per second for 
30. seconds* 



POD>MONITOR/INTERVAL»5/TIME»100 $ZTIME+2, $PATCH 
Example 18 Monitoring Server Memory Locations 



Command File Support 



Allows a user to define standard procedures for analyzing 
data* Any valid POD command can be used in a command procedure* 

NOTE 

There is no indirect command support for POD 
command files (eg. there is no support for ifs, 
elses, etc.) 



POD.CMD 

SHO LOG 

SET SERVER ROUTER 

SET IMAGE/DEPOSIT/UNPROTECT/ NODE-BARNEY 

SET REGION EXECUTIVE 

EXAMINE $PARHD 

EXAMINE/ STRUCTURE =PCB @ 

EXIT 

@P0D 

Example 19 POD Command File 



37 



Node Troubleshooting 



Log File 



The Log File allows users to send output to a terminal, log 
file, or both. There are two commands used to control where the 
output will go. The SET LOG command identifies the log file where 
the output will be sent. The SET OUTPUT command determines 
whether the output goes to the terminal, log file, or both. 



POD>SET LOG ROUTER. LOG 
POD>SET OUTPUT LOG 

Example 20 Setting Up a Log File for Output 



Symbol Table Support 



If a user wishes to examine or deposit into a specific 
location in memory, it may be specified either in octal or by a 
symbolic expression. POD maintains three symbol tables: 



o User Symbol Table 

Contains symbols defined by the user using the DEFINE 
command • 



o Region Symbol Table 

- Symbols that depend on the particular region specified and 
whose context changes with the region context. 

When the region is changed (<SET REGION>), a file 
PODxxx.SYM (xxx * RTR, X25, etc.) is read to determine the 
proper .STB file for the new region. Since each server 
product includes its own set of regions, there is a 
specific .SYM file for each server product (PODRTR, 
PODX25, etc.). 



o System Symbol Table 

- Contains Executive symbols. 
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o System Symbol Table 

Contains Executive symbols. 
- This table never changes. 



Define 



The DEFINE command allows a user to define a symbol by 
assigning It a 16-bit alphanumeric value. If the user attempts to 
define a symbol that Is already used, POD displays a warning 
message. User symbols may not be defined more than once without 
first being UNDEFINED. When a symbol Is referenced, the User 
Symbol Table Is searched first, then the Region Symbol Table. If 
an exact match for a symbol Is not found, the symbol with the 
closest but lower value -Is displayed with an octal offset. If a 
symbol has been defined In the user symbol table as well as In 
either of the other two tables then the symbol In the user table 
takes precedence. 



POD>DEFINE TEMP-10 



Example 21 Defining POD Symbols 



39 



Node Troubleshooting 

Data Structure Interpreter Support 

o Displays data in a numerical format in octal, decimal, or 
hexadecimal numbers. 

o Displays data in ASCII or RAD 50 strings. 

o Displays data in symbols or offsets from symbols. 

o Assigns ASCII text to values that the data can have. 

o Interprets data as a field of bits, bytes, words, or double 
words • 

In example 22, the data structure ZBLOCK starting at address 
F00 is examined. 

P0D>EXAMINE/STRUCTURE-ZBL0CK F00 
Example 22 POD Command for Examining a Data Structure 

When examining data structures, a user may wish to follow 
pointers from one structure to another. POD allows this through 
the CHAIN command. 



40 



Node Troubleshooting 



POD>EXAMINE *PARHD 

♦PARHD / 1U734 

POD>EXAMINE/STRUCTURE«PCB @ 

Partition Control Block 
P.LNK » 111670 
Priority a 0. 
10 + IOSB count * 0. 
Partition Name * CEXPAR 
PoSUB » 000000 
P. MAIN - 111734 
P.REL « 001120 
P. SIZE • 000060 
Wait Queut » 000000 111774 
Swap Sizt * 111794 
Busy Flaas * 200 200 
P.TCB = 000000 
Startina APR * 

CoMMon 
P.HDR • 000000 
Protection word « 177777 

Attachment Descriptor Listhead * 000000 111772 
POD>CHAIN 

Partition Control Block 
P.LNK » 111624 
Priority a 0. 
10 + IOSB oount * 0. 
Partition Name » NT POOL 
P. SUB * 057324 
P. MAIN ■ 111670 
P.REL • 001200 
P. SIZE = 003740 
Wait Queue = 000000 111710 
Swap Size * 111710 
Busy Flass * 200 200 
P.TCB * 000000 
Startina APR ■ 

System controlled 
P.HDR - 000000 
Protection word = 000000 

Attachment Descriptor Listhead = 000000 111726 
POD> 



Example 23 Using the Chain Command 
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CRASH DUMP ANALYSIS 



The server software supports up-line crash dumps over the 
Ethernet. Whenever the server node fails, it automatically dumps 
its memory into a file on a host node. The file can be dumped to 
the designated host, or if the designated host is not available, 
the file can be dumped to any available host listed in the 
server's backup host list. Once dumped, the file can be analyzed 
by POD. 



Prerequisites for Up-line Dump 



Setting up the data base for performing the up-line dump 
depends on the host operating system. RSX and TOPS hosts use the 
CFE utility, VMS hosts use NCP. 



RSX/TOPS host commands: 



o Circuit UNA-0 must be set to the ON state and SERVICE ENABLED 
o Enter the command: 



CFE>DEFINE NODE 136 NAME BARNEY - 
DUMP FILE BARNEY. DMP - 
HARDWARE ADDRESS AA-00-03-00-00-06 - 
HOST RSXHOST - 

DIAGNOSTIC FILE LB : [ 100 , 1 00 ] CSVLDI . SYS - 

LOAD FILE LB: [100, 1 00 ] CSVRTR. SYS - 

SERVICE CIRCUIT UNA-0 - 

SERVICE PASSWORD (HEX) - 

SECONDARY LOADER [ 1 00 , 1 00 ] PLUT02 . SYS 

TERTIARY LOADER [ 100, 100] PLUT03 . SYS 



Example 24 Setting Up the Up-line Dump File on RSX Hosts 
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VMS host commands: 



o Circuit UNA-0 must be ON and ENABLED for SERVICE functions 
o Enter the command: 



NCP>DEFINE NODE 134 NAME BARNEY - 
DUMP FILE BARNEY .DMP - 
HARDWARE ADDRESS AA-00-03-00-00-06 - 
HOST VMSHOST - 

DIAGNOSTIC FILE LB : [ 100, 100JCSVLDI . SYS - 
LOAD FILE LB: U00,100]CSVRTR.SYS - 
SERVICE CIRCUIT UNA-0 - 
SERVICE PASSWORD (HEX) - 

SECONDARY LOADER LB : [ 100, 100] PLUT02. SYS - 
TERTIARY LOADER LB : [ 1 00 , 100 ] PLUT03 . SYS 



Example 25 Setting Up the Up-line Dump File on VMS Hosts 
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Up- line Dump 



When the server detects a condition that it cannot recover 
from, it requests the loading host to accept an up-line dump. If 
that host is unable to accept the dump, the server asks the first 
host on its backup list (obtained from the configuration file 
loaded with the server software). If every host on the backup 
list rejects the dump, the server sends it to a multicast address; 
the first available host that is able to accept the dump will 
respond • 



SERVER 
MOP 12 

Request Dump Service 



HOST 



MOP 14 



Memory Dump Data 



MOP 14 



Memory Dump Data 



MOP 1 



Dump Complete 



MOP 4 



Request Memory Dump 



MOP 4 



Request Memory Dump 



MOP 4 



Request Memory Dump 



Example 26 Message Exchange During an Up-line Dump 
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Forcing a Crash Dump 

When the server Is up and running but no activity Is taking 
place (the server seems to "hang"), it is necessary to force a 
crash dump to determine the cause of the problem. Forcing the 
server to crash depends on the host operating system and also uses 
the Remote Console Facility of the server. 

The Remote Console Facility (RCF) allows a user to set up a 
logical connection between a terminal connected to a host and the 
server hardware unit's console interface. This allows the remote 
terminal to act as the server's console. Table 7 shows the 
command format for running CCR. 



Table 7 CCR Command Format 

CCR NODE node-id [SERVICE PASSWORD password] 

[SERVICE CIRCUIT circuit-id] 
[PHYSICAL ADDRESS e therne t-addr ess ] 



NOTE 

The Service password, circuit, and address only 
need to be specified if they are not defined in 
the host's down-line load database for the server. 



Invoking CCR on an RSX Host 

CCR can be Invoked by: 

>RUN CCR (if it is not installed) 

or 

>CCR NODE node-id (if it is installed). 



The server responds with: 



CCR> 



Once the connection to the server node has been established the 
following mesage will be displayed: 

CCR — Remote Console is Reserved 
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Node Troubleshooting 



VMS Hosts 



A terminal that Is connected to a VMS host can remotely 
connect to the server's console Interface by using the NCP CONNECT 
command. The CCR and the CCS Image are Installed In SYS$SYSTEM by 
VMSINSTAL. In VMS the CCS serves as the Interface to NCP. To 
connect the VMS host to the server, one of the following commands 
Is used: 

NCP>CONNECT NODE node-Id 
or 

NCP>CONNECT VIA CIRCUIT UNA-0 PHYSICAL ADDRESS AA-00-04-00-B6-04 



Once the connection has been established, the server responds 
with : 

Console Connected (press CTRL/D when finished) 

Once the host (either RSX or VMS) is connected to the 
server's console; Table 8 shows the procedure that will force a 
crash dump. 
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Node Troubleshooting 



Table 8 Commands and Server Responses to Force a Crash Dump 



User Command 



Server Display 



Server Response 



<CNTRL/B> 



Current PC address 



0100/ 
<RET> 
@address/ 

@addr/cont 3 <RET> * 



(3100/address 
@addr ess /con tents 



Initiates a break 
In processing 

Indicates the server 
has halted 

An octal address 



Contents of the 
location Is 
displayed 



@P 



[Server node crashes] 



Causes the server 
processor to cont- 
inue 



NOTE 

The 3 that is entered is the address of a 
breakpoint trap* When the trap is encountered, 
the server will begin to dump* The front panel of 
the server will dlplay "d" followed by a series of 
digits. There will also be event messages on the 
host indicating that the server memory is being 
dumped. Example 27 shows a sample VMS session 
forcing a crash dump: 
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Node Troubleshooting 



$NCP CONNECT NODE ROUTER 

Console Connected (type "D when done) 

~B 

001260 
§100/016122 

§016122/004567 3 <RET> 
@P 
~D 
$ 

Example 27 Forcing a Crash Dump from a VMS Host 



Analyzing a Crash Dump 



When the server crashes, a dump file Is sent to a host node. 
This name of the dump file is specified in the down-line 
load /up-line dump database. This file can be analyzed by using 
the POD facility. 



>RUN POD 

P0D>SET SERVER ROUTER 

P0D>SET IMAGE DUMP - [Accnt ] BARNEY. DMP 
Example 28 Analyzing a Server Dump using POD 
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Drift Software Product^ Description 



PRODUCT NAMEi DECntt Router, Version 1.0 SPD „• 30. 34.00 



DESCRIPTION* ; 

The OECnet Router Server is a software oroduct tnat runs on an 
Ethernet Communications Server hardware unit to provide DECnet routing 
functions in a network of one or more host computers -* be they Phase" 
IV routlno nodes or endnotes , or Phase III routiner nodes or endnodes, 
(e.g., OECnet-RT V2.0 and DECnet/E V3.0). The OECnet Routed Server 
connects directly to the Ethernet to provide pouting to node* off tne 
Ethernet and "connected via the unit's synchronous lines. These- nodes 
can be remote Phase III/IV routing nodes or endnodes, or other DECnet 
Router servers connected to other Ethernets. endnodes connected 
directly to an Ethernet must use OECnet Pouter Servers or Phase IV 
host routing nodes connected to the same Ethernet to enable message 
routing off that Ethernet. A routing node is not require* on an 
Ethernet ir the endnodes connected to that Ethernet communicate only 
with each otner. Use of tne OECnet Router Server enables the 
offloading of certain communications processing on nost nodes that 
would otherwise serve as routing nodes on the Ethernet. 

Tne DECnet' Router Server lmoiements Phase IV DSCnet routing and 
network *ahaaement. Througn the us* of Phase iv OECnet protocols, 
DECnet computer networks can contain up to 1023 nodes given prooer 
networ< Planning. Aiono with providing Ethernet support, the- DECnet 
Router server is compatible with Phase III implementations; ~ this 
provides mioration of °nase III networks with connectivity to Phase iv 
Ethernet nodes. 

The DECnet »outer Server is warranted for use only with sunnorte-i 
Pnase III and Phase IV products supplied by DIGITAL. 



A-jaotive Routine 

The OECnet Router Server functions as. a dedicated routino node wit?* 
one or *ore communications lines connecting nodes off an -:th«rnet to 
nodes on that Ethernet, ^itn adaptive routing, a message received 
from a Phase IV/III node addressed to another P*ase I li I node win 
be forwarded by the intermediate Phase IV/III nodes in this case 
the Router "• Server. Routino is not suooorte* to or from pnase II 
nodes. 

Althouoh two adlacent routine nodes can be connected oy m-sre than one 
physical Tin*, messages will oe sent over only one of the tinws. Ail 
other lines' will serve as "hot standby*" sucn tnat tne least cost path 
available s between two nodes is the ore tnat win oe used for wessaae 
traffic. A nne cost parameter set bv the syste* manager determines 
tne line over which all messages win ce sent from one node to an 
ad j acent node ,~ 
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Network Management 

The Network Management Utility on any Phase IV OECnet nost node can 
execute commands remotely at the OECnet Router server to nerforn three 
primary functions: display statistical and error information, control 
tne operation of the server, and test network operation. Ail network 
management functions are oerformed from a node loaicaliy connected to 
tne server* rather tnan from tne server itself. 

A remote operator can cnoose to display statistics related to the 
server node itself or tne communications lines, including traffic and 
error data. The remote operator can also perform ,nany network control 
functions such as starting and stooping lines, and downline ioadina 
tne Pouter software into the server. 

A remote operator can log network events Cfor tne OECnet aouter server 
node) to a terminal device or other event sin* on a Phase IV DECnet 
nost node suooortino this caoability. The ->»etwor< Management utility 
can be used to enaole and disable the event looglna facility at the 
host. 

Network v anaqer*ent can also &e used to test components of tne network. 
A remote ooerator can transmit and receive test messages ' over 
individual server lines between tne server and* remote nodes. The 
nessaies can then be conoared for possible errors. Network management 
allows a looicai series of tests to be oerfomed, thereby aidino in 
isolating network problems. 



Communications 

The o^oet Pouter Strver uses Ethernet Communications Server line 
cards to connect network nodes. Tne Cnwunicati^ns Server line cards 
connect an intelligent controller within tne unit that provides DMA 
access to server ^e^ory and implements line contmi an^ error recovery 
orocedures . This module imolements the nisital Data Comnt»«*i-ations 
^essane Protocol CHOC *P) to orovide full- or half-duolex 
communications over ooint«to-ooint syncnronous lines. The 
Communications server line cards interface to standard TjITAI 
synchronous line controllers (e.g., o^Pin via M -iTAu-sunolied -31 A 
RS-232C/CCITT V.24 and V.35 caoies. Mote that tne Communications 
Server does not supoort asvncnronous ooc^P lines cr multipoint lines. 

Tne Ethernet Co™unications Server interfaces to tne Ethernet via an 
intelligent Ethernet controller pac<aoel *ith the nardware unit. 



OECnet Pouter server nneration 

The Ethernet communications Server hardware provides tne necessary 
maintenance operation protocols for loaaing OECnet °oiter software 
from an Etnernet load host, over the Etnemet, and into server ^enory. 
All software, includina diaanostics, are downline loaded into the 
unit. In the event of certain hardware or software naif unction , tne 
unit win attempt to ucline dump the Pouter server software and 
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automatically invoke reload. 

A configuration file on one or more host load nodes defines parameters 
for the operation of the Router server. This Information Is ^efi.nea 
at Installation time and can oe modified oy the System/network Manager 
for reconfiguring the server upon subsequent reloading. 



Router Server Configuration and Performance 

The process of configuring the OECnet Pouter node Is eased Primarily 
on tradeoffs of cost and performance within tne real* of satisfying 
the users' aoolicatlon requirements. It can oe expected tnat networ* 
aopilcatlons will range from low-speed, low-cost situations (e.g., 
connecting few remote nodes over low soeed communications lines) to 
those of relatively high oerformance (e.g., connecting two Ethernets). 
Primarily* the oerformance of a given CSCnet Router node is a function 
of tne exoected network traffic and resultant processing pursuant to 
the dedicated function of the unit. Thus node oerformance depends on 
several factors: 

o Communication line characteristics 

o Size of Buffers 

o Quantity ani frequency of route-tnrouqn traffic 

It is important to note that the rate at wnich user data can be 
transmitted (throughout) over a communications line can *ometi-»es 
approach, but win never reacn, the actual line soeed, Tne actual 
throuohout is a function of many factors, including the line aualltv, 
protocol overhead, toooloov, and networ* appilcatlon(s) , as well as 
the factors cited In this section. 

The table below ^escrioes the physical nard^are configurations 
suooorted bv the n^Cnet Router server In ter*s ot communications 
interface. 



Maximum Line Sr»eed 
(Kilobits/sec) 



Line Card Tyoe 



ur to 19,2 



5-5 



250 



50 



DCSAX-LA (FDX/HOX) 



N/A 



N/A 



M / * 



DCSAX-L? (FOX/HDX) 



M/A 



8 



2 



1 



Note that the total number of line cards supoorted fry the hardware 
unit is eight, an<1 that the aggreqate line throughout cannot exceed 
500 Kilobits oer second. 
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In order to achieve a viable conf iguration, the user and /or a OIGITAL 
software soecialist should perform a level of aopiication analysis 
wnien addresses the faetors aoove. In the preceding ta*ie, the 
following definition applies: Maximum line soeed — the fastest cIock 
rate at which the number of line cards speclfed can be driven under 
the OECnet Router server. The actual maximum data throughout can not 
be calculated by multiplying the number of lines by the line soeed, 
since many factors already discussed In this seetlon will reduce the 
actual throughput. 



MINIMUM HARDWARE REQUIRED: 

The OECnet Router software runs in the fallowing Ethernet 
Communications Server packaged hardware option: 



o DECSA-EA Ethernet Communications Server hardware, including one 
PCSAX-LA line card (sinole line EIA PS-232C/CCITT V.24 
syncnronous to 19. 2K bos, f DX/HDX ) . 



One of the following cables snould be used with the DCSAX-LA line 
card:. 



o 80.70 Mull mode* cable for local connections 

o 3C17C £14 extension caole for remote (no^en) connections 



The Ethernet Communications Server hardware requires both a 
transceiver droo cable and Ethernet interface H400u or nEVH to 
connect to the Etnernet nnvsical channel. 

Because all software to run on the Ethernet Com-u^i-ation* 3* r ver is 
downline loaded fro* a OECnet Phase IV Ethernet . lna* node, cnis node 
must nave a ^ao-etic taoe or RL02 dis< drive to read tine d Istr Ibucio* 
•pedia. This node should also nave 1200K ovtes of dis< soace to store 
the Router software for sueseouent downline loading. 



OPTIONAL HARDWARE: 

Additional Ethernet Communications Server line caras (OCS*X-LA and/or 
DCSAX-LB), uo to the naxlmum defined in cne Configuration and 
Performance section of this SPo, can be added to the oac<aqed 
hardware. T.ine card tvoes: 



o OCSAX-LA Sinole line EIA RS-232C/CCITT V.24 synchronous to 19. 2K 
bos, Fnx/HDX. Use 9C17D (null m-nde«T) or BC17C (EIA 
extension) cables. 

o HCSAX-L9 Sinole line CCITT V.35 synchronous to 500K oos, 
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FDX/HDX. Uft BC17E (full modem) cables. 



PREREQUISITE SOFTWARE I 

Phase XV DECnet support on ont or more Ethernet Communications Server 
load hosts Con the Ethernet). These Include: 

DECnet-RSX CV4.0 - 11-M/V2.0 - 11-M-PLUS) 

DECnet-VAX V3,l 



OPTIONAL SOFTWARE: 

None 



TRAINING CREDITS: 

No training eredlts are Included with an Ethernet Communications 
Server software license. Training courses on OECnet software are 
sch iled at regular Intervals In DIGITAL'S training Centers. 
Arr :ements should be made directly with (DIGITAL'S Educational 
Services Department. 



SOFTWARE CATEGORY: 
DIGITAL SUPPORTED 

The OECnet Router Server Is a DIGITAL Sueoorted Software Product* 



If DIGITAL Installation Service has been provided, then during the 
ninety (90) dav period following Installation, DIGI1AL will orovlde 
the following standard services If the customer encounters a aroolem 
with the software Product: 

(a) If DIGITAL aLso determines the proolem to oe a defect in the 
Software Product* DIGITAL will orovlde remedial service on site 
if necessarv Ci) to aoply a teroorary correction or na*e a 
reasonable attemot to develop an emergency bypass if the software 
is inooerable, and (2) assist the customer in preparing a 
Software Performance Report CSPR). 

If DIGITAL Installation Service has not oeen provided, tnen 
during the ninety (90) day period following installation, eitner 
from tne date of first use by the customer or thirty (30) days 
after delivery (r.'J.B. Diaital's oiants), whichever occurs 
first, if the customer encounters a non-installation related 
orobiem with the software product, OIGITAL will provide the 
followina warranty services. 

(b) If customer diaonosis indicates the problem is caused by a defect 
in the Software Product, it may suomit an SPR to DIGITAL. 
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DIGITAL will respond to oroolems reported In SPRs that are caused 
by defects In the current, unaltered release of the Software 
Product in a manner appropriate to the severity of the problem. 

Telephone support Is available, at no additional charge, from the 
DIGITAL Telephone Suooort Center for a ninety (90) day period 
commencing either from the date of first use of this Software Product 
by the customer or thirty C30) days after delivery, whichever comes 
first. 

Any Uedates to the software Product released by DIGITAL during the 
ninety C90) day oerlod will be provided to the customer on DIGITAL 
standard distribution media as specified in this SPD. 

These services will be provided in locations within the United states, 
except AiasKa. otherwise, service will be provided in the country of 
purchase, service required because of customer use of other than the 
current, unaltered release of the Software Product operated in 
accordance with the SPD win be provided at DIGITAL'S then current 
rates, terms, and conditions. 



SOFTWARE INSTALLATION: 
CUSTOMER INSTALLED 

The DECnet Router Server Is a Customer Installed Software Product, 
There Is an ontional installation service available for Server 
software products. 

Optional DIGITAL installation is recommended for tnis software 
product. This service is described under the "Additional Services" 
section of this Software Product uescrlotion. 

DIGITAL recommends that only tnose customers wn« nave sufficient 
technical resources should attemot its installation without DIGITAL'S 
assistance, 

DIGITAL Installation Service Is availaole, orovlded the customer 
reauests this service within 30 days of product delivers CF.O.S, 
Digital oiants). 



WARRAMTY LIMITATIONS: 

The customer may ourchase DECnet Router Server licenses *ith options 
that do not include suooort services. The category of sunoort 
aooiicable to such software is Customer Suoporte*. When a network 
contains DECnet oroduct ootions, whicn were purcnased without warranty 
services and/or are not currently covered by a DIGITAL Software 
Product Service contract, DIGITAL will respond to only those problems 
that occur or can be demonstrated by the customer to occur among nodes 
that are under warranty service or a current DIGITAL Software Product 
Service Contract, 
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PREREQUISITE SUPPORT: 

A Network Profile and DECnet Customer Suooort Plan covering all 
Intended networ* nodes and their support may be required. 



ORDERING INFORMATION: 

All binary licensed software, lncludlno any suosequent uodates, is 
furnished under tne licensing provisions of DIGITAL'S Standard Terns 
and Conditions of Sale, which orovide in part that the software and 
any part thereof *ay be used on only the single server CPU on wnlch 
tne software is first executed , and may be coiled, in whole or in oart 
(with the orooer inclusion of the CIGITAL copyright notice and any 
DIGITAL oroorietary notices on the software) only for use on sucn CPU. 

Ootlons witn no support services are available only after the ourchase 
of one suoported license. 

A single-use, license-onl/ option is a license to copy the software 

previously obtained under license. 

The following Key (H, *, Z) represents the distribution media for the 
product and must be soecified at the end of the order number* e.g.* 
QE725-AH = binaries on 9L02 disK cartrHae. 

H s 3L02 disK cartridce 

M s 9-trac* lfiOO 3PI magtape (PE) 

2 s n*o hardware ieoendenc/ 



Refer to tr.e following ta^le for available options. ^iote tnat tne 

ootlons are defined by the load host uron wnicn tne software "ill oe 

installed for sutseauent Ethernet loading into the Ethernet 
Communications Server. 



Table 



Ootlons 



Lead Hosts 



VAX/ VMS 



M-PL!'S 



11/730 



11/750 



1J/780 



Single use 
license 



1C725-AH 



Q0725-AX 



QE725-AX 



QP7 25-AX 



Single use 
license-only 



QLAOl-DZ 



Uo-iate/Unsuooorte* 



0C725-MH 



Q0725-HX 



QE72S-KX 



UP725-HX 



Update, license-only 0C725-HZ Q0725-HZ 3E725-HZ QP725-HZ 
Documentation QC725-GZ QD725-GZ 0E725-GZ QP725-GZ 



ADDITIONAL SERVICES: 

The following post- warranty Software Product Services for the software 
product are available to licensed customers: 



o Self -Hiintenance Service 

o Basic service 

o HECsupoort Service 



Customers should contact their local DIGITAL office for additional 
information on the availability of these services. 

Installation services 

For a fixed orlce a DIGITAL Software Specialist win assure- that the 
customer's system is ready for Installation, install the software, and 
familiarize the customer with its operation. 

Installation for the DECnet Router Server will consist of the 
following: 

o Verification that all comoonents of the DECnet Router Server nave 
been received. 

o Verification that the necessary versions of the host software and 
documentation are available. 

o Creation of che necessary OECnet Pouter server accounts ana 
directories , 

o Creation of the Network Conf iourati^n file. 

o Installation of DECnet Router Server software. 

o Verification of the orooer installation for tne o^Cnet Router 
Server by runnino a series of tests to s*ow connectivity to a 
hosts connected to the DECnet Router. 

Connectivity to all otner nodes within the net*orfc Is the 
resoonsibility of the customer. 

Pre-Instaliat ion Procedures Reouired 

Before DIGITAL can install the software, the customer musts 
o Ensure that the system meets the minimum hardware and software 



reoulrements (as specified In the SPD). 

o Obtain, install, and demonstrate as operational any no*e«*s and 
other equipment and facilities neeessary te Interface digital's 
communication eguloment. 

o Designate one node to verify Installatlon/connectlvltv. 

o Make available for a reasonable period of time, as mutually agree? 
upon oy DIGITAL and the customer, an hardware communications 
facilities and terminals that are to te used during Installation* 



Delays caused by any failure to meet these resoonslbintles will 
be charged at the prevailing rate for time and materials. 
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1.0 OVERVIEW 



The Pluto On-line Debugger (POD) is an analysis tool for examining the 
memory of a running server system, a server dump image, or the 
distribution image for a server product. And in the case of a running 
server systems, deposits are allowed into memory. 

The Pluto hardware configuration does not include a console terminal, 
nor does the Server Base Include any software which communicates with 
a console terminal. Therefore, any general interactive support tools 
must be run from a host system. POD runs on such a host system in 
cooperation with a Remote Examine/Deposit server task (RED...) which 
is part of the Server Base. 

POD has been developed to support the following areas of diagnosing 
software problems in Pluto nodes: 

1. Obtain information not provided by event logging or by 
network management commands. This includes the examination 
of data structures, trace buffers, possibly corrupted code, 

• etc • 

2. Insertion of debug code in a running server system to 
determine if (and perhaps how often) certain points in the 
code are reached, and to save the contents of pertinent data 
cells at such an event. Insertion of debug code can also be 
used to force a crash dump at a selected point. A scratch 
data area exists in the Server Base for this purpose. 
Starting at location $PATCH, there are 100 octal bytes 
available for code insertion. 

3. Allow the tailoring of on-line and crash dump analysis report 
generation and to allow symbolic, interactive examination of 
dump images and running Pluto systems. 

POD supports command files and formats data structures to allow 
analysis procedures to be pre-defined and easily invoked. References 
to memory locations may be made using symbols. Several data types are 
supported for the entry and display of data. POD is implemented in 
BLISS and runs under RSX-1 lM/M-Plus , and VMS. POD.TSK or POD. EXE 
reside in a standard Pluto directory on the host node, along with a 
•SYM file (containing symbol Information) and a .DSD file (containing 
data structure information). 

Before issuing any examine commands a server type, image and region 
context must be established. 

A server type may be set to one of the following: 
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1. Router 

2. Terminal Server 

3. X25 Gateway/Router 

4. SNA Gateway 

An image context may be set to one of the following: 

1. a distribution image of a server product 

2. a dump image from a crashed Pluto node 

3. memory in a running Pluto node 

A region context may be set to one of the following: 

1. the 22-bit physical address* space (Excluding the I/O page) 

2. the executive virtual address space (Including the I/O page) 

3. the virtual address space of an RSX-11S task, common, DECnet 
process, etc. 



2.0 SECURITY 

The POD utility allows its user to examine or deposit into any memory 
location in a running Pluto* An unauthorized user must be prevented 
from engaging in such activities as "spying" on a data entry session 
at a Voyager terminal, or from modifying such input data, or from 
crashing the node at will. Therefore, POD access to a running server 
node will require that the user have an appropriate level of 
privileges at the host. On a VMS host, the user must have operator 
privilege, and on RSX, the user must be running POD from a privileged 
account • 

Examine/deposit requests from POD are serviced over a logical link by 
the RED... task running in a server. Only one such logical link may 
be open at a time. 
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3.0 DATA TYPES FOR ENTRY AND DISPLAY 

Data that is entered and displayed during POD operations is 
interpreted under the current "TYPE" and "LENGTH" settings. These are 
user-set table parameters, which initially default to "octal" and "word" 
respectively. These defaults may be changed with the SET TYPE and SET 
LENGTH commands. Additionally, a type and/or length to be used during 
the execution of a particular command can be specified by applying a 
qualifier to that command. See the description of the EXAMINE or 
DEPOSIT commands for specific information on the data types and 
lengths supported. 

When data is being interpreted numerically on output, all decimal 
values are treated as signed numbers and all other numeric values 
handled as unsigned numbers. On input, however, numerical data 
supplied as command parameters are treated as unsigned numbers and are 
translated from ASCII according to the input radix specified in the 
SET TYPE command. 



4.0 COMMAND FILE SUPPORT 

POD includes command file support. This gives the user a mechanism 
for defining standard procedures for analyzing data. Any valid POD 
command can be used in a command procedure. 



5.0 DATA STRUCTURE SUPPORT 

POD allows the user to examine data structures producing an 
appropriately formatted display. This syntax supports the following 
capabilities : 

1. Displaying data in a numerical format as octal, decimal, or 
hexadecimal numbers. 

2. Displaying data as ASCII or RAD 50 strings. 

3. Displaying data as symbols or offsets from symbols. 

4. The user can also assign ASCII text to values that the data 
can have • 

5. Data can be interpreted as a field of bits, a byte or a word. 
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6.0 SYMBOL TABLE SUPPORT 

When a location is specified in an examine or deposit operation, that 
address may be specified in terms of an octal or symbolic expression. 
Such an expression is comprised of one or two terms, separated by a 
or • A term may be an octal number or a symbol. 

POD maintains three symbol tables - a User Symbol Table, containing 
symbols that can be DEFINEd and UNDEFINed by the user, a Region Symbol 
Table, whose content changes with region context, and a System Symbol 
Table. When region context changes (by issuing a SET REGION command), 
the . SYM file will be read to determine what symbol table Information 
should be loaded for a particular region. Since each server product 
will include a different set of regions, there will be a specific .SYM 
file for each server product (PODRTR.SYM, PODSNA.SYM, PODX25.SYM, 
PODTS.SYM) . 

Symbol naming must follow the conventions stated in the description of 
the DEFINE command. Each symbol has a 16-bit value associated with 
it. To resolve a symbol reference, the User Symbol Table is searched 
first, then the Region Symbol Table and finally the System Symbol 
Table. When a value is being displayed in symbolic mode, and an exact 
match cannot be found in any symbol table, that symbol which has the 
closest but lower value (within 100 octal) will be displayed with an 
octal offset. (eg. $XYZ + 40) 
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7.0 COMMAND SYNTAX AND FUNCTIONALITY 



The following section describes the commands available in POD, 
including a detailed description of what the command does for the user 
and the particular syntax for the command. 

Each command has the following format: 

command [keyword] [/qualifier] [parameter] 

command - A verb indicating the general function to be performed. 

keyword - Indicates, in conjunction with command verb, the specific 
function to be performed by the command. 

/qualifier - Modifies the effect of the command. 

parameter - Qualifies the function in some way, such as specifying a . 
range of locations to be monitored. 



Also the following characters, if used as a part of a qualifier or 
parameter, are interpreted to have special meaning: 

1. @ (Contents Operator) - requests the debugger to extract the 
contents of the location previously examined and use this as 
the next address to- examine. 

2. : (Range Operator) - is used to specify a range of addresses 
for an EXAMINE command. 

3. ! (Comment Indicator) - indicates that a comment is to 
follow. 
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8.0 SUMMARY OF COMMANDS 



BREAK 

CHAIN 

CONVERT 

DEFINE 

DEPOSIT 

DISPLAY 

EXAMINE 

EXIT 

HELP 

MAP 

MONITOR 
NOBIAS 
NOMAP 
SET 

IMAGE 

LENGTH 

LOG 

OUTPUT 
REGION 
SERVER 
TYPE 

SHOW 

IMAGE 

LENGTH 

LOG 

OUTPUT 
REGION 
SERVER 
STRUCTURE 
SYMBOL 
TYPE 
UNDEFINE 

The following sections describe the commands supported. (For 
examples of their use see Appendix B.) 
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9.0 COMMANDS 

9.1 @ 



Description : 

The @ command instructs POD to begin taking commands from the 
indicated file. Command procedures, also called indirect command 
files, can be invoked wherever any other command can be given and can 
contain any valid POD command. 

Format : 

@f ile-specif ication 

Command Parameters : 

file-specification 

Specifies the name of the command procedure to be executed. 
If a file type is not specified, the debugger will search for a file 
with the .COM type on a VMS host and a . CMD type on an RSX host. The 
file specification must be in the appropriate format for the host 
operating system that POD is running under. 

Filespecs must be entered as quoted strings, unless the user 
is just specifying a filename and type. 

Command Qualifiers: 

None . 

Example : 

9P0D.COM 
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9.2 BIAS 



Description : 

Specifies a value to be used for mapping into physical memory. 
It is intended to be used to emulate the mapping provided by the 
extended pool mechanism ($XBIAS et. al.) in the Server Base. Once 
the bias command has been issued, any odd address(es) specified during 
a command (such as EXAMINE and DEPOSIT), causes the virtual address to 
be translated into a 22-bit address. The low bit of the virtual 
address is cleared and the bias value specified is used as a block 
number in translating to 22-bit address, and the location referenced 
will be examined. 

Note: If a byte length has been specified on an EXAMINE command 
(either by a qualifier or a previous SET LENGTH command), then a /BIAS 
switch must also be specified. Otherwise the virtual address will 
just be treated as a byte address, not as a bias specific address. 

(NOTE: The BIAS command can be abbreviated to one character, B.) 

Format : 

BIAS bias-value 
Command Parameters : 
bias-value 

The bias-value specified can either be a 16-bit octal number 
or a symbol. If a symbol is specified, the contents of the symbol is 
used as the bias-value, not the symbol's address. And in the case of 
an octal number, the number Itself is used as the bias-value. (Note: 
$XBIAS is usually used as the bias-value. And no check is performed 
to determine whether the bias-value could cause the physical 
address(es) to go beyond the physical memory limit. If this occurs, 
an error message will be displayed when attempting to EXAMINE or 
DEPOSIT using bias.) 

Command Qualifiers: 

None • 

Example : 



BIAS $XBIAS 
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9 . 3 BREAK 
Description : 

The BREAK command will transmit a message to a running server 
node which will cause the system to crash and hence up-line dump. 
This command is only applicable when working against a running node 
and when the /BREAK has been specified on the last SET IMAGE command. 
(See the SET IMAGE command for further details.) 

Format : 

BREAK 
Command Parameters : 
None • 

Command Qualifiers: 
None • 

Example : 

BREAK 
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9,4 CHAIN 



Description : 

Allows the user to chain through data structures. A reference 
name must have been previously specified as part of the structure 
definition. If this has been done, you can use the reference name 
specified to look at a structure of a different type, which is pointed 
to by the structure you just examined. 

If you did not previously examine a structure, this command is 
invalid and an error message will be displayed. 

The CHAIN command can also be used to look at the next 
structure of the same type you are currently examining. This is done 
by not specifying a reference name when you enter the command. (Note: 
This is equivalent to performing a EXAMINE <cr> (next operation) if 
your display type is STRUCTURE). 

(Note: Structure names and reference names are described in Appendix 
A.) 

Format : 

CHAIN [structure-reference-name] 

Command Parameters: 

structure-reference-name 

The reference name is optional, and is the name of the field 
through which the referecne occurs. (This is defined when the data 
structure definition is written.) 

Command Qualifiers : 

None • 

Example : 



CHAIN P.TCB 
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9.5 CONVERT 
Description: 

The CONVERT command displays the octal, decimal, hexadecimal, 
ASCII, RAD50, and symbolic equivalent for the specified value. The 
value specified is interpreted based on the current input TYPE. 

Format : 

CONVERT value 
Command Parameters : 
value 

An input value that is Interpreted according to the first type 
parameter specified in the last SET TYP$ command. (see the SET TYPE 
command for further details.) 

Command Qualifiers: 

None • 

Example : 

CONVERT 100 
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9.6 



DEFINE 



Description : 



The DEFINE command lets you define a symbol and assign a 16 



bit value to the symbol. A warning will be displayed if a user 
symbol, being DEFINEd, is previously defined in either of the other 
two symbol tables. A user symbol cannot be defined more than once. 
The user must first UNDEFINE the symbol before attempting to redefine 
it. 

The debugger always searches for user defined symbols first. 
Consequently, symbols in the User Symbol Table have precedence over 
symbols in the remaining symbol tables with the same name. To 
reference a symbol in another symbol table which has the same name as 
a symbol you have defined, you have to first UNDEFINE the user defined 
symbol • 



Note: If you change regions, the symbol in the User .Symbol 



Table still takes precedence over a symbol in another symbol table 
which has the same name. If this occurs, the user will be informed 
that there's a multiply defined symbol. The user then has the option 
of UNDEFINing that symbol from the User Symbol Table. 



DEFINE [/qualifier] symbol * data 
Command Qualifiers 



/ASCII 

/DECIMAL 

/HEXADECIMAL 

/OCTAL 

/RAD 50 

/SYMBOL 



Command Parameters: 
symbol 

Specifies the name of the symbol to be defined. The following 
rules must be followed when defining a user symbol. 

- Symbols can be composed of alphanumeric characters (A-Z and 
0-9), dollar signs ($) or periods (.). 



Format : 
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- The first character must not be numeric (0-9). 

- The symbol cannot exceed 6 characters in length. 

data 

Specifies the data to use for the symbol definition. The data 
is interpreted according to the qualifier specified, ie. ASCII, 
DECIMAL, HEXADECIMAL, OCTAL, RAD50, SYMBOL. If no type or length 
qualifier is specified the current input setting, specified on the 
last SET TYPE command, is used. (See the SET TYPE command for further 
details.) 

Command Qualifiers: 
/ASCII 

Specifies that the data is Interpreted as ASCII characters. 
If two ASCII characters were not specified, the remaining portion of 
the word is blank filled. 

/DECIMAL 

Specifies that the data is to be interpreted as an unsigned 
decimal number. 

/HEXADECIMAL 

Specifies that the data is to be interpreted as hexadecimal 

digits. 
/OCTAL 

Specifies that the data is interpreted as an unsigned octal 

value . 
/RAD 50 

Specifies that the data is to be interpreted as RAD 50 
characters. Any time a RAD 50 string doesn't fill up a word (three 
RAD50 characters can fit in a word), the remainder of the word will be 
blank filled. 

/SYMBOL 

Specifies that the data is to be interpreted as a symbolic 
expression. A symbolic expression can be a one or two term 
expression, separated by a plus (+) or a minus(-) sign. A term can be 
either a symbol or an octal constant. The value of the symbol is used 
in defining the user symbol. 

Example : 



DEFINE TEMP = 10 
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9.7 DEPOSIT 



Description : 

The DEPOSIT command allows you to modify the contents of 
memory locations in a running server image. If you enter more than 
one value, the values are deposited at sequential memory locations 
starting with the specified location. Deposits into sequential memory 
locations occur as an atomic (ie. unlnterruptable) operation. 

Data values to be deposited can be specified in numeric, ASCII 
or RAD50 string, or symbol format. 

The DEPOSIT feature is not intended to be used as a patching 
facility. It should be used only to assist in diagnosing problems. 
Any code inserted should only be temporary. (A scratch data area 
exists in the Server Base for depositing debug code. Starting at 
location $PATCH, there are 100 octal bytes available.) To use this 
command the /DEPOSIT switch, must be specified on the SET IMAGE 
command. 

The default mode for deposits is "protected". This requires 
the users to first EXAMINE a location, or range of locations, before 
attempting a DEPOSIT. This supports the presumption that the user 
really only wishes to change the content of a memory location to a 
specific value based on his knowledge of its current content. If the 
running server system changes the value before the deposit can be 
performed, the above will prevent the deposit from taking place and 
the user is informed. 

In the case mentioned above, where the server system changes the 
values of locations before a deposit can be made, an "unprotected" 
mode of operation can be enabled. This is done by including the 
/UNPROTECT qualifier to the DEPOSIT command. In this case RED... 
will perform the deposit without any validation of current content. 
(NOTE: To use this capability the /UNPRODEP switch must also have 
been specified on the SET IMAGE command.) 

(NOTE: The DEPOSIT command can be abbreviated to D.) 



Format : 

DEPOSIT [/qualif ier(s) ] expression » data [,data...] 
Command Qualifiers 



/ASCII 
/BYTE 
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/DECIMAL 

/HEXADECIMAL 

/OCTAL 

/RAD50 

/SYMBOL 

/UNPROTECT 

/WORD 
Command Parameters : 
expression 

Specifies the location in which to deposit the data. This 
location may be specified as either an octal or symbolic expression. 
Such an expression is comprised of one or two terms, separated by a 
"+" or "-" . A term may be an octal number or a symbol. 

data 

Specifies the data to be deposited. The data is interpreted 
according to the qualifier(s) specified. Qualifiers are of two 
categories. They are either type qualifiers (ASCII, DECIMAL, 
HEXADECIMAL, OCTAL, RAD 50 , SYMBOL) or length qualifiers (BYTE, WORD). 
If no qualifiers are specified the default is the current settings for 
"TYPE" and "LENGTH" . (See the SET LENGTH and SET TYPE commands for 
further details.) 

Command Qualifiers: 

/ASCII 

Specifies that the data is ASCII characters. When the length 
specified is word and there aren't an even number of ASCII characters 
(two ASCII characters can fit in each word) in the string, the 
remaining portion of the last word will be blank filled. 

/BYTE 

Specifies that the unit of data being deposited is in bytes. 
For each data item specified the debugger deposits one byte of data. 
An error will occur when a value is entered that exceeds what can be 
stored in a byte (a value greater than 255, unsigned). 

/DECIMAL 

Specified that all data is to be interpreted as unsigned 
decimal numbers. 
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/HEXADECIMAL 

Specified that all data following is to be interpreted as 
hexadecimal digits. 

/OCTAL 

Specifies that the data will be interpreted as unsigned octal 

values • 
/RAD50 

Specifies that the data is to be interpreted as RAD 50 
characters. The smallest unit that a RAD50 string can be deposited 
into is a word. Therefore, if the length has been specified as a 
byte, either by using a qualifier or by the SET LENGTH command, an 
error message will be displayed. Also, any time a RAD50 string 
doesn't fill up a word (three RAD50 characters can fit in a word), the 
remainder of the word will be blank filled. 

# 

/ SYMBOL 

Specifies that the data is to be Interpreted as a symbolic 
expression. A symbolic expression can be a one or two term 
expression, separated by a plus (+) or a minus(-) sign. A term can be 
either a symbol or an octal constant. The value of the symbol is used 
in depositing into the location specified. 

/UNPROTECT 

Specifies that the current deposit operation is to be 
performed without checking the current contents (ie. there is no 
protection against inadvertant mistakes). This requires that the last 
SET IMAGE command included a "/UNPRODEP" qualifier. 

/WORD 

Specifies that the unit of data being deposited is a word. 
For each data item specified the debugger deposits two bytes of data. 
If a value is specified which exceeds what can be stored in a word 
(greater than 65,535, unsigned), an error will occur. 

Example : 

DEPOSIT/BYTE/ASCII SYSPAS + 1 - T,E,S,T 
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9.8 



DISPLAY 



Description : 



The DISPLAY command can be used following an EXAMINE command 



to redisplay the contents of a specified address or range of addresses 
which where specified in the last EXAMINE command. 

The DISPLAY command does not cause the target image to be accessed. 
The contents of the addresses obtained from the last EXAMINE command 
can be redisplayed many times over with the DISPLAY command in numeric 
form, ASCII or RAD50 string form, as symbols where possible. 

An error message is displayed if the user attempts to execute a 
DISPLAY command before executing an EXAMINE command. 



DISPLAY [/qualif ier(s) ] 
Command Qualifiers 



/ASCII 

/BYTE 

/DECIMAL 

/HEXADECIMAL 

/OCTAL 

/ RAD 50 

/ STRUCTURE 

/SYMBOL 

/WORD 



Specifies that the contents of the memory location(s) should 



be displayed as ASCII characters. (Note: Control characters are 
displayed as spaces.) 



Format : 



Command Qualifiers: 



/ASCII 



/BYTE 



Specifies that the data should be displayed in byte entities. 
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The format of how this data is displayed will be determined by either 
a type qualifier, if specified, or what was specified in the SET TYPE 
command. The initial default is octal. (See the SET TYPE command for 
further information.) 

/DECIMAL 

Specifies that all data should be displayed in decimal as 
signed numbers. 

/HEXADECIMAL 

Specifies that all data should be displayed as hexadecimal 

digits . 
/OCTAL 

Specifies that the data will be displayed as octal digits. 

/RAD 50 

Specifies that the data is to be displayed as RAD50 
characters. It must be displaying a field with a minimum length of a 
single word and the addresses specified must start on an even byte 
boundary. Otherwise an error will occur. 



/STRUCTURE 

Specifies that a tailored output format will be used for 
displaying the data. The format has been predefined by a structure 
definition. The output format will be the same as what was specified 
for the previous EXAMINE command. If the previous EXAMINE command did 
not specify a structure, an error message is displayed. 

/SYMBOL 

Specifies that the data is to be displayed symbolically, 
whenever possible. Otherwise, it will be displayed as an octal offset 
from a symbol. If this not possible, the default will be to output 
the value as an octal number. 

/WORD 

Specifies that the data should be displayed as word entitles. 
The format of how this data is displayed will be determined by either 
a type qualifier, if specified, or what was specified in the SET TYPE 
command. The initial default is octal. (See the SET TYPE command for 
further information.) 

Example : 



DISPLAY/BY/DEC/ HEX 
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9.9 EXAMINE 
Description : 

The EXAMINE command displays the contents of a specified 
address or range of addresses. If an address is omitted the next 
sequential location in memory is examined. The contents of the 
addresses can be displayed in numeric form, ASCII or RAD50 string 
form, or as symbols where possible. 

The contents may also be displayed as formatted output, When a data 
structure display format is specified, the data won't be displayed in 
any of the other display formats (see Appendix A for further details). 

An examine of a range of addresses occurs as atomic (ie. 
uninterruptable) operation on a running server. 

(NOTE: The EXAMINE can be abbreviated to E.) 

Format z 

EXAMINE [ /qualifier ( s) ] [expression [ :expression] ] 
Command Qualifiers 



/ASCII 

/BIAS 

/BYTE 

/DECIMAL 

/HEXADECIMAL 

/OCTAL 

/RAD 50 

/STRUCTURE » structure-name 

/ SYMBOL 

/WORD 
Command Parameters : 
express ion 

Specifies the location to be examined. This is an optional 
parameter, which if specified can be either an octal or a symbolic 
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expression. Such an expression Is comprised of one or two terms, 
separated by a "+" or "-" . A term may be an octal number or a symbol . 

If an expression is not specified the location is incremented 
by the appropriate amount and the next location is examined. 

If a range is specified, (expression .'expression) the first 
address must be less than the second address, whether they are 
specified symbolically or as an octal numbers. Otherwise, an error 
message will be displayed. 

Command Qualifiers: 

/ASCII 

Specifies that the contents of the memory location(s) should 
be displayed as ASCII characters. (Note: Control characters are 
displayed as spaces.) 

/BIAS 

Indicates that the addresses are to be translated into 22-bit 
physical addresses, using the bias value specified in a preceeding 
BIAS command. (See the BIAS command for further details.) 

/BYTE 

Specifies that the data should be displayed in byte entitles. 
The format of how this data is displayed will be determined by either 
a type qualifier, if specified, or what was specified in the SET TYPE 
command. The initial default is octal. (See the SET TYPE command for 
further information.) 

/DECIMAL 

Specifies that all data should be displayed in decimal as 
signed numbers. 

/HEXADECIMAL 

Specifies that all data should be displayed as hexadecimal 

digits . 
/OCTAL 

Specifies that the data will be displayed as octal digits. 

/RAD 50 

Specifies that the data is to be displayed as RAD50 
characters. It must be displaying a field with a minimum length of a 
single word and the addresses specified must start on an even byte 
boundary. Otherwise an error message will be displayed. 
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/STRUCTURE * structure-name 

Specifies the name of a structure definition to be used in 
examining locations in memory. Implicit in the structure definition 
is the range of memory locations to be examined. You only need to 
specify the starting location to be examined. If a range is specified 
the second expression will be ignored. (See Appendix A for further 
details • ) 

/SYMBOL 

Specifies that the data is to be displayed symbolically, 
whenever possible. Otherwise, it will be displayed as an octal offset 
from a symbol. If this not possible, the default will be to output 
the value as an octal number. 

/WORD 

Specifies that the data should be , displayed as word entities. 
The format of how this data is displayed will be determined by either 
a tyfce qualifier, if specified, or what was specified in the SET TYPE 
command. The initial default is octal. (See the SET TYPE command for 
further information.) 

Examples : 

EXA $LDBRT+10 

EXAMINE/DEC/RAD 100:120 

EX . 

EXA $PARHD 
E/STR-PCB (3 



EX 
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9.10 EXIT Or *Z 



Description: 

Ends the debugging session and returns control to the 
operating system. 

Format : 

EXIT or *Z 
Command Parameters: 

None • 
Command Qualifiers: 

None • 

Example : 

EXIT 
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9.11 HELP 
Description : 

The HELP command displays a list of available debugger 
commands. (NOTE: There Is no Intention to provide a full help 
capability In POD for security reasons.) 

Format : 

HELP 

Command Parameters : 

None • 
Command Qualifiers: 

None. 

Example : 

HELP 
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9.12 MAP 



Description : 

Specifies that a mapping into physical memory is to occur for 
any address(es) within the APR context specified. This mapping is 
performed transparently by POD. If it is determined that the virtual 
address specified falls within the APR(s) specified for mapping, the 
map value entered is used as a block number and the virtual address 
specified is converted to a 22-bit physical address using this block 
number • 

If an APR is not specified as a switch on this command, the default is 
assumed to be APR 6. 

(Note: Mapping can be specified for more than one APR at a time.) 
Format : 

MAP [/qualifier] map-value 
Command Qualifiers 



/APR * apr-number 
Command Parameters: 
map-value 

An 16 bit octal value to be used as a bias into physical 
memory, for address(es) within the specified APR context. (Note: No 
check is performed to determine whether the map-value could cause the 
physical address(es) to go beyond the physical memory limit. If this 
occurs, an error message will be displayed when attempting to EXAMINE 
or DEPOSIT using mapping.) 

Command Qualifiers: 

/APR * apr-number 

Indicates the APR for which mapping is to be used. The 
default if this switch is not specified is to use APR 6 for mapping. 
Example: 



MAP/APR-4 14030 
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9.13 MONITOR 



Monitors a location or locations and indicates if the contents 
change during a specific time interval. (This is done by examining 
locatiion(s) periodically, not continuously.) The contents of all 
specified locations are displayed initially, based on the current 
display type setting. After this, any location and its contents are 
displayed only when changes are detected. This command is allowed 
against a server running system only. By default, POD will re-examine 
the locations, word/byte based on the current length setting, every 
second for a period of 30. seconds. 

Command Format: 

MONITOR [ /qualif ier(s) ] expression [, expression ... ] 

Command Qualifiers 



/WORD 
/BYTE 
/TIME 
/INTERVAL 
Command Parameters : 



expression 

Specifies the location ( s ) to be monitored. A maximum of five 
locations are allowed. A location may be either an octal expression 
or a symbolic expression. Such expressions are comprised of one or 
two terms, separated by a "+" or "-" . A term may be an octal number 
or a symbol. 

Command Qualifiers: 

/BYTE 

Specifies that the location(s) to be monitored are in byte 

lengths • 



/INTERVAL-seconds 

Specifies the interval between re-examination of the monitored 
location(s). A value between 1 and the time specified in the time 
qualifier is allowed. The default is 1 second. 

/TIME-seconds 

Specifies the duration in which to monitor the location(s). A 
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value between 1 and 300* seconds is allowed. The default Is 30. 
seconds* 

/WORD 

Specifies that the locatlon(s) to be monitored are in word 

lengths • 



Example : 



M0NIT0R/INT-5/TIME-100 $ZTIME+2, $PATCH 
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9.14 NOBIAS 
Description: 

Cancels a previous BIAS command and indicates that no bias 
operations are to be performed* 

Format : 

NOBIAS 
Command Parameters: 

None • 
Command Qualifiers: 

None • 

Example : 

NOBIAS 
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9.15 NOMAP 
Description : 

Cancels a previous MAP command. Indicating that a mapping 
operation is not to be performed for the specified APR. If an APR is 
not specified as a switch on this command, the default is APR 6. 

Format : 

NOMAP [/qualifier] 
Command Qualifiers 



/APR » apr-number 
Command Parameters: 

None • 

Command Qualifiers: 

/APR ■ apr-number 

Indicates the APR for which mapping is to be cancelled. The 
default if this switch is not specified is to cancel APR 6 mapping. 

Example : 

N0MAP/APR-4 
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9.16 SET 



Description : 

Enables the user to set the server context within which 

examines are to take place, by specifying the generic type of server 

product, the specific server image and the region within this image. 

The user can also Indicate how to display addresses, where to output 
any information from a debugging sessions, the name of a log file for 
output, how to display the examined data. 

See the individual command descriptions following for more 
information • 

(NOTE: The SET command can be abbreviated to S.) 
Format : 

SET keyword [/qualifier] parameter 
Command Keywords : 

ADDRESS, IMAGE, LENGTH, LOG, OUTPUT, REGION, SERVER or TYPE 
Command Parameters: 

Depends on keyword specified. 
Command Qualifiers: 



Depends on keyword specified. 
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9.16.1 



SET ADDRESS - 



Description : 



Sets the display type for addresses which are being examined* 



The address types control whether the addresses are displayed in octal 
and/or symbolic form. 



The default display of addresses is in symbolic form. The 



parameter specified in the SET ADDRESS command will override the 
current defaults. The addresses may be displayed in octal form, 
symbolic form, or both. 



SET ADDRESS address-keyword [, address-keyword] 



Commamnd Parameters : 
address-keyword 

This can be OCTAL or SYMBOLIC. 
Command Qualifiers: 

None • 

Example : 

SET ADDRESS OCTAL , SYMBOLIC 



Format s 
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9.16.2 SET IMAGE - 
Description: 

The SET IMAGE command specifies the target image upon which 
POD operations are to be applied. Such an image may be a running 
server node, a server product distribution image, or a crash dump of a 
server node. An appropriate keyword must be applied to identify the 
node name or filename of the image. 

The qualifiers of the SET IMAGE command specify how the target 
image can be accessed. They are only valid when the target image is a 
running server node. They specify whether the user can make use of 
the BREAK command and what deposit types (protected or unprotected) 
are allowed. See the descriptions of the BREAK and DEPOSIT commands 
for further details. 

Format : 

SET IMAGE [ /qualif ier(s) ] image-keyword [node-qualifiers] 
Command Parameters : 
image -keyword 

Specifies the target image upon which POD operations are to be 
performed. Valid image-keywords are NODE, DUMP, or DISTRIBUTION and 
the syntax associated with each is described below. 

NODE-nodename 

Specifies the name of a running server node to be examined. A 
valid nodename can consists of up to six alpha or numeric characters 
and the first character cannot be a number. 

Node-qualifiers are optional qualifiers to allow access control 
information to be specified. 

USER » username 
PASSWORD ■ password 

DUMP-f ile-specif i cat ion 

Specifies the name of a dump image file. The default file 
type is .CD A. 

Filespecs must be entered as quoted strings, unless the user 
is just specifying a filename and type. 

DISTRIBUTIONS ile-specif icat ion 

Specifies the name of a distribution image for a server 
product. The default file type is .SYS. 

Filespecs must be entered as quoted strings, unless the user 
is just specifying a filename and type. 

Command Qualifiers: 
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NOTE : 

These qualifiers are only valid when the target image is a 
running server node. 

/DEPOSIT 

Specifies that the user can do protected deposits, which 
requires the user to first examine the locatlon(s) before making a 
deposit to the locatlon(s). 

/UNPRODEP 

Specifies that the user can perform an unprotected deposit, 
which means that a deposit can be made without any validation of the 
data at the location(s) specified. (Note: If you specify this 
switch, you are automatically given the ability to do protected 
deposits, as well.) 

/BREAK 

Specifies that the user has can Initiate a BREAK command which 
will cause a running server system to crash. 



Examples : 



SET IMAGE/DEP NODE-BOOJUM USER-SYSTEM PASSWORD-PRIV 



SET IMAGE DUMP - "LB : [40, 6] EOMER.CDA" 



SET IMAGE DIST 



RSX11S.SYS 
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9.16.3 SET LENGTH - 
Description : 

Sets the default length for commands such as DEPOSIT and 
EXAMINE • The initial length is WORD. A qualifier may be specified in 
the DEPOSIT or EXAMINE command, to override the setting for one 
command • 

Format : 

SET LENGTH length-keyword 
Command Parameters: 
length-keyword 

Specifies the default length. The length-keyword can either 
be BYTE or WORD. 

BYTE 

Specifies that the default length is byte. 

WORD 

Specifies that the default length is word. 
Command Qualifiers: 
None • 

Example : 



SET LENGTH BYTE 
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9.16.4 SET LOG - 
Description: 

Specifies the file specification of the log file that the 
debugger uses when the output is directed to a log file. 

The SET LOG command only controls the name of the log file. 
It doe 8 not control whether to output Information to a log file. This 
is done by the command SET OUTPUT. 

If no log file name is specified, the debugger will default to 
a file specification of POD. LOG. If the debugger is currently 
creating a log file and you enter SET LOG, the debugger does not 
closes the existing file. Tou must turn logging off and back on again 
to cause the debugger to close the file you are currently logging to 
(see the SET OUTPUT command for further details). If a file name is 
specified and that file already exists, a new version will be 
generated • 

Format: 

SET LOG file-specification 
Command Parameters: 
file-specification 

Specifies the name for the log file. The file specification 
must be in the appropriate format for the host operating system that 
POD is running under. The default file specification is POD. LOG. 

Filespecs must be entered as quoted strings, unless the user 
is just specifying a filename and type. 

Command Qualifiers: 
None • 

Example : 



SET LOG KIM.TST 
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9.16.5 SET OUTPUT - 
Description: 

Controls where the debugger sends its output: to the 
terminal, a log file, or both. 

When the debugger is initiated, all debugger responses are 
displayed at the terminal and no log file is created. 

Format : 

SET OUTPUT option [.option...] 
Command Parameters : 
option 

Specifies the output mode. Valid options are LOG, TERMINAL, 
or their negatives, N0L06 or NOTERMINAL. 

LOG 

Enables output to a log file. The log file contains all the 
commands that are entered at the terminal and all debugger responses. 
NOLOG, which is the default setting, Inhibits output to a log file. 

TERMINAL 

Enables output to the terminal. This is the default option. 
NOTERMINAL causes the debugger to stop displaying commands and 
responses to the terminal. 

Command Qualifiers: 

None • 

Example : 

SET OUTPUT LOG 
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9.16.6 SET REGION - 
Description: 

The SET REGION command establishes an address space context 
within the current image. This may be the 22-bit physical memory 
space or some 16-bit virtual address space, such as for a specific 
task. 

The Region Symbol Table Is reloaded when setting a region. 
POD will load one or more .STB files, symbol information, from the 
current .SYM file that is opened. 

Format : 

SET REGION region-name 
Command Parameters: 
region-name 

Supported regions are "PHYSICAL" (22-bit address space), 
"EXECUTIVE" (virtual address space of RSX executive, Comm Exec and I/O 
page) or "name", where "name" is an existing task, common, driver, 
dynamic region, or DECnet process. "Name" must have an associated 
Partition Control Block in RSX-11S DSR (ie. task name, common name, 
or device name). 

Setting a region to "PHYSICAL" will result in an empty Region 
Symbol Table. Setting a region to "EXECUTIVE" will result in the 
loading of CEX.STB (the Executive and Communications Executive symbol 
information) into the Region Symbol Table and the enabling of virtual 
address references corresponding to APR's 0-4 and 7. 

When a region name is specified whose base APR is 5 or 6 (eg. for a 
privileged task or region), POD also allows the user access to the 
"EXECUTIVE" address space and corresponding symbols transparently 
(APR's 0-4 and 7). 

Command Qualifiers: 

None • 

Example : 



SET REGION NT.XPT 
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9. 16,7 SET SERVER - 
Description : 

This command establishes a context to a specific server 
product, and hence names a .DSD and . SYM file for this context. 
Different node and file images can be set to within this context. 

Format : 

SET SERVER server-type 
Command Parameters : 
server-type 

This can be ROUTER, TERMINAL, SNA, X25. 

ROUTER 

Refers to the Router Server product. 

TERMINAL 

Refers to the Terminal Server product. 

SNA 

Refers to the SNA Gateway. 

X25 

Refers to the X25 Gateway and Router product. 
Command Qualifiers: 
None • 



Example : 

SET SERVER ROUTER 
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9.16.8 SET TYPE - 
Description: 

Sets the default entry type and display types. The entry type 
and display types control whether the data is interpreted in a radix 
form, as ASCII or RAD 50 strings, symbolically or in the case of 
display only, as a data structure. 

More than one type keyword can be specified for displaying the 
data and the data will be output in the various forms. However, when 
one of the display types is STRUCTURE , the data will only be displayed 
as a data structure. A warning message will be issued if the user 
attempts to set type to structure and something else. 

In the case of the entry type (ie. how to interpret input data) only 
one form is allowed. If more than one type keyword has been 
specified, the first keyword will be Interpreted as the default entry 
mode • 

You can override the current type by using a qualifier with 
commands such as DEPOSIT, DISPLAY or EXAMINE • If the type has not 
been set, using either the SET TYPE command or a qualifier, the 
default is octal, for both input data and display data. 

If the type has been set to SYMBOL, values are displayed as 
symbols or offsets from symbolic locations. The debugger first looks 
for an exact match with a symbol. It will first search the User 
Symbol Table, then the Region Symbol Table, and if necessary the 
System Symbol Table. If no exact match can be found, the debugger 
searches for the symbol closest to the value, but not further away 
than a lOO(octal). If it cannot find any symbolic definition, it 
displays the value in octal. 

Format : 

SET TYPE type-keyword [, type-keyword ] 
Command Parameters: 
type-keyword 

Specifies the entry and display type(s). The type-keyword( s ) 
can be ASCII, DECIMAL, HEXADECIMAL, OCTAL, RAD 50 , STRUCTURE or SYMBOL. 
Whenever one of these display types is invalid for interpreting the 
data, the data will be interpreted in octal. 

ASCII 

Specifies that the data is to be interpreted as ASCII 
characters. (Note: Control characters are displayed as spaces.) 

DECIMAL 

Sets the current radix to decimal. 
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HEXADECIMAL 

Sets the current radix to hexadecimal. 
OCTAL 

Sets the current radix to octal. 

RAD 50 

Specifies that the data Is to be Interpreted as RAD 50 characters. 

STRUCTURE * structure-name 

Specifies that the data Is to be displayed as a data structure 
and structure-name Indicates which data structure definition Is to be 
used for displaying data. Structure definitions have been predefined 
and are included when the server context is specified (see Appendix A 
for further details.) 

(Note: This is not a valid entry form, the input type will default to 
octal • ) 

SYMBOL 

Specifies that the data is to interpreted symbolically. 
Command Qualifiers: 

None. 
Examples: 

SET TYPE DEC , HEX, SYM 

SET TYPE STRUCT-RNN 
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9.17 SHOW 



Description : 

Allows the user to look at what type of server product Is 
being examined* the specific image being looked at, and the region 
within this image that the user is set to. The user may also show 
where the output information from the debugging session Is being 
placed, the name of a log file for output, the type being used to 
interpret the entry and display of data, and the length for handling 
the data. Also, the user can display the octal value associated with 
a symbol or symbols. 

See the individual command descriptions following for more 
information • 

Format : 

SHOW keyword [/qualifier] parameter 
Command Keywords : 

IMAGE, LENGTH, LOG, OUTPUT, REGION, SERVER, SYMBOL or TYPE 
Command Parameters: 

Depends on keyword specified. 
Command Qualifiers : 

Depends on keyword specified. 
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9.17.1 



SHOW IMAGE - 



Description : 



The SHOW IMAGE command displays the current image context, 



including the identifying nodename or filename. 
Format : 

SHOW IMAGE 
Command Parameters : 

None • 
Command Qualifiers: 

None • 

Example : 

SHOW IMAGE 
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9.17.2 



SHOW LENGTH - 



Description : 



Shows the default length (ie. words or bytes) being used by 



the DEPOSIT, EXAMINE and DISPLAY commands. 
Format : 

SHOW LENGTH 
Command Parameters: 

None • 
Command Qualifiers: 

None • 

Example : 

SHOW LENGTH 
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9.17.3 SHOW LOG - 
Description : 

Displays the name of the log file* Format: 

SHOW LOG 
Command Parameters: 

None • 
Command Qualifiers: 

None • 

Example : 

SHOW LOG 
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9.17.4 SHOW OUTPUT - 
Description : 

Shows where the output is being sent. 

Format : 

SHOW OUTPUT 
Command Parameters : 

None • 
Command Qualifiers: 

None • 

Example : 

SHOW OUTPUT 
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9.17.5 SHOW REGION - 



The SHOW REGION command displays the current region context, 
including the virtual address space and the number of symbols that 
have been loaded into the Region Symbol Table. 

Format : 

SHOW REGION [qualif ier(s) ] 
Command Parameters : 



None • 



Command Qualifiers: 
/ALL 

In addition to the current region context, a list of all known 
regions for the current image is displayed 

Examples : 

SHOW REGION 

SHOW REG/ALL 
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9.17.6 SHOW SERVER - 
Description: 

Displays the current server product type being accessed, the 
name of the . SYM file, from which the symbols are loaded, and the 
number of symbols in the System System Table. 

Format : 

SHOW SERVER 
Command Parameters : 

None • 
Command qualifiers: 

None • 

Example : 

SHOW SERVER 
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9.17.7 SHOW STRUCTURE - 
Description: 

Displays the names of structures which have been defined for 
formatting output. (see Appendix A for further details). 

Format : 

SHOW STRUCTURE 
Command Parameters: 

None • 
Command qualifiers: 

None • 

Example : 

SHOW STRUCTURE 



Pluto On-Line Debugger 
COMMANDS 



Page 50 
12 Apr 84 



9.17.8 SHOW SYMBOL - 
Description : 

The SHOW SYMBOL command Is used to display, in octal, the 
value of a symbol or symbols, if defined. Wildcard characters can be 
used in the symbol specification. The wildcard character, "%", will 
match on any single character. The wildcard character, "*", will 
match on any string, including null strings. 

Format : 

SHOW SYMBOL [/qualifier] symbol-name 
Command Parameters: 
symbol-name 

Specifies a string whose value from the User, Region, and/or 
System Symbol Tables will be displayed, depending on the qualifier 
used. If no qualifier is specified, all three symbol tables will be 
searched for matching symbol names. The symbol-name specified may 
include wildcard characters. 

Command Qualifiers: 

One and only one, of the following qualifiers can be used. If 
no qualifier is specified, the default will be to reference all three 
symbol tables. 

/USER 

Indicates that the symbol table to be referenced will be 
limited to the USER Symbol Table 

/REGION 

Indicates that the symbol table to be referenced will be 
limited to the REGION Symbol Table 

/SYSTEM 

Indicates that the symbol table to be referenced will be 
limitd to the SYSTEM Symbol Table 

Example : 

SHOW SYMBOL $XBIAS 

SHOW SYMBOL/SYSTEM $TKPS 

SHO SYM $T* 



SHO SYM %.* 



Pluto On -Line Debugger Page 51 

COMMANDS 12 Apr 84 

9.17.9 SHOW TYPE - 
Description : 

Displays the current types for interpreting and displaying the 

data • 
Format: 

SHOW TYPE 
Command Parameters: 

None • 
Command Qualifiers: 

None . 

Example : 

SHOW TYPE 
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9.18 UNDEFINE 
Description : 

The UNDEFINE command clears the definition of a user defined 

symbol . 
Format : 

UNDEFINE symbol 
Command Parameters: 
symbol 

Specifies the name of the symbol to be cleared. 
Command Qualifiers: 
None • 

Example : 

UNDEFINE TEMP 



APPENDIX A 
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POD Data Structures for the Server Base Executive 



The following data structures have been defined for the Server Base executive 
(RSX-11S v4.0). For each data structure, Its name, associated pointers, source 
macro name (from EXEMC.MLB) and list header or other access Information Is 
provided. 



CRASH 



The crash macro Is used to print out the contents of the machine 
registers that were saved when the system crashed. Only those 
registers that correspond to the PLUTO hardware are printed out 
(for example, no Supervisor Mode registers or D Space APRs are 
shown) . 

Access to the crash registers Is via the exec location $CRSST, viz: 

POD> examine/ s t rue ture»c rash $CRSST 

There are no structures referenced from structure CRASH. 

There Is no corresponding EXEMC.MLB macro name. 

Example : 

Crash Registers 
Before Crash 

PC - 016070 

PS - 000010 
After Crash 

PS - 000340 

SP(K) - 123036 

SP(U) = 000410 
Registers 

R0 - 177434 



DATA STRUCTURE DEFINITIONS 



Page A-2 
12 Apr 84 



Rl - 

R2 - 

R3 = 

R4 » 

R5 - 
Memory 

MMRO = 

MMR1 - 

MMR2 - 

MMR3 - 
User I 
PDRs 

APR 

APR 

APR 

APR 

APR 

APR 

APR 

APR 
PARS 

APR 

APR 

APR 

APR 

APR 

APR 

APR 

APR 
Ke rnel 
PDRs 

APR 

APR 

APR 

APR 

APR 

APR 

APR 

APR 
PARs 

APR 

APR 

APR 

APR 

APR 

APR 

APR 

APR 



177777 
177777 
000000 
000000 
000000 
Management Registers 

000017 

000000 

024356 

000020 
Space 

077406 
077406 
077406 
077406 
077506 
077406 
077406 
077506 

000000 
000200 
000400 
000600 
000577 
000600 
001400 
177600 
I Space 

077506 
077506 
077406 
077406 
077406 
077506 
077406 
077506 

000000 
000200 
000400 
000600 
001000 
017710 
001400 
177600 
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CLKQ 



The clock queue macro is used to print Clock Queue Control Blocks. 
The last 3 words displayed (Type-Dependent Area) have different 
interpretations depending on the value of C.RQT. (clock request type). 

Access to the head of the list of clock queue entries is at $CLKHD, 

POD>examine $CLKHD 
POD>examine/s tructure-clkq @ 

Chaining down the list of clock queue entries is done by 

POD>examine 
or 

POD>chain 

If the clock queue entry relates to a task, the corresponding . TCB 
can be accessed by 

POD>chain C.TCB 

The EXEMC macro is CLKDF$. 

Example : 

Clock Queue Control Block 
C.LNK - $INITL+000026 
C.RQT - Internal Routlne-Ident 
C.EFN - 0. 
C.TCB - 062714 
C.TIM - 31005400000 

Type-Dependent Area » 122040 015040 101054 
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DCB 

The DCB structure describes Device Control Blocks. The head of the 
list is at $DEVHD. 

POD>examine $DEVHD 
POD>examine/s tructure-DCB @ 

Chaining down the list of DCBs is done by 

POD>examine 
or 

POD>chain 

The list of UCBs corresponding to the DCB can be accessed via D.UCB, 

POD>chain D.UCB 
The PCB for the driver (if any) is accessed via D.PCB, 

POD>chain D.PCB 
The EXEMC macro is DCBDF$. 
Example : 

Device Control Block 
D.LNK » 063004 
First UCB = 064236 
Device Name 3 NS 
Unit numbers (low, high) » 000 
UCB length » 000040 
D.DSP = 122232 

Legal, Control, NOP, ACP - (0-15) » 
Legal, Control, NOP, ACP - (16-31) 
Driver PCB » 064410 



000 



000001 000001 000000 000000 

037000 020000 000000 017000 
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TSKHDR 



The TSKHDR structure describes the task header. The task header is 
accessed from P.HDR in the corresponding PCB. The structure display 
always shows entries for LUNs 1 to 10, even though, not all LUNs may 
be in use. 

The various AST blocks can be accessed from the task header, viz: 

P0D>chain H.PFVA 
P0D>chain H.FPVA 
P0D>chain H.RCVA 
P0D>chain H.RRVA 

The Window Blocks for the task may be accessed via H.WND - H.WND 
points to a word containing the number of window blocks, followed 
immediately by the window blocks themselves. 

The EXEMC macro is HDRDF$. 

Example : 



Task Header 
Current Stack Pointer - 000000 
Header Length - 000206 
Event Flag mask, addr * 107117 



131722 



Current UIC 
Default UIC 
Initial PS » 
Initial PC « 
Initial SP « 



001 

001 
170017 
124572 
121270 



001 
001 



ODT SST vector length, addr » 
Task SST vector length, addr * 
Powerfail AST block » 000000 
FP AST block = 000000 
Receive AST block » 000000 
Event flag save - 000000 
FP save - 140206 
Window Blocks ■ 056156 
Directive Status - 000000 
FCS impure ptr » 000000 
Fortran impure ptr - 000000 
Overlay impure ptr ■ 000000 
Work Area ptr - 000000 
Swapping Priority » 0. 
Mailbox LUN - 000 
Receive by reference AST block • 
X.25 byte - 000 
Guard word - 056220 
Number of LUNs - 000011 
LUN table 
LUN 1 = 064612 000000 
LUN 2 = 064612 000000 



000000 
000000 



000000 
000000 



000000 



DATA STRUCTURE DEFINITIONS 



LUN 


3 - 


064612 


000000 


LUN 


4 - 


064612 


000000 


LUN 


5 * 


064612 


000000 


LUN 


6 - 


064612 


000000 


LUN 


7 - 


064612 


000000 


LUN 


10 - 


064612 


000000 
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HDRWND 



The HDRWND structure describes the Window Blocks in the Task Header 
for a task. The Window Blocks are accessed via H.WND in the Task 
Header • 

Access to the next (adjacent) Window Block is available by: 

POD>examine 
or 

POD>chain 

but the user must know when to stop, by the count in the word 
preceedlng the first Window Block (and pointed to by H.WND) 

The PCB corresponding to the task can be accessed via W.BPCB, 

POD>chain W.BPCB 

The attachment descriptor corresponding to the Window Block can be 
accessed via 

POD>chain W.BATT 

The EXEMC macro is HDRDF$. 

Example : 

Window Block 
PCB address » 106720 
Low VA » 120000 
High VA * 142077 
Attachment Descriptor - 106704 
Blocks in window » 000221 
Physical Block Address » 000000 
First PDR * 001212 
Number of PDRs » 003002 
Last PDR value » 010006 
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ADB 

The ADB structure describes Attachment Descriptor Blocks. The ADBs 
are accessed via W.BATT in the corresponding Window Block. 

Successive ADBs that correspond to the same Partition (PCB) can be 
obtained by 

P0D>examine 
or 

POD>chain 

Successive ADBs that correspond to the same Task (TCB) can be 
obtained by following down the TCB attachment thread, subtracting 
6 from the address contained therein. 

The TCB corresponding to the task can be accessed via A. TCB, 

POD>chain A. TCB 
The PCB for the task is accessed via A. PCB, 

POD>chain A. PCB 
The EXEMC macro is PCBDF$ 
Example : 

Attachment Descriptor 
PCB Attachment thread » 000000 
Task Priority = 205. 
1/0 count ■ 0. 
TCB of attached task » 107130 
TCB Attachment thread » 000000 

Delete Access 

Write Access 

Read Access 
Mapping Count = 1 . 

PCB of attached task = 106720 
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PCB 

The PCB structure describes Partition Control Blocks. The head of the 
list is at $PARHD. 

P0D>examine $PARHD 
POD>examine/ a tructure-PCB @ 

Chaining down the list of PCBs is done by 

P0D>examine 
or 

POD>chain 

The main partition or next sub-partition can be accessed via P. MAIN 
or P. SUB, viz: 

. POD>chain P. MAIN 
or' 

POD>chain P. SUB 
The Wait Queue is chained through P. WAIT, 

POD>chain P. WAIT 
The TCB for the task is accessed via P.TCB, 

POD>chain P.TCB 
The Task Header is accessed via P.HDR, 

POD>chain P.HDR 

The llsthead for the Attachment Descriptors for the partition 
is accessed via P. ATT, 

POD>chain P. ATT 

The EXEMC macro is PCBDF$. 

Example : 



Partition Control Block 
P.LNK - 000000 
Priority - 205. 
10 + IOSB count - 0. 
Partition Name - GEN 
P. SUB - 110304 
P. MAIN = 111230 
P.REL » 007245 
P. SIZE - 000045 
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Wait Queue - 000000 000000 

Swap Size - 000000 

Busy Flags » 000 000 

P.TCB - 111114 

Starting APR - 

System controlled 
P.HDR - 110740 
Protection word - 000000 

Attachment Descriptor Llsthead - 110660 110320 
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AST 



OCB 



The AST structure describes AST Blocks. AST blocks are referenced from 
a number of places, Including the Task Header (see TSKHDR structure). 

AST blocks may be queued up, so the list may be traversed by 

POD>examine 
or 

POD>chain 
The EXEMC macro is PKTDF$ • 



The OCB structure describes Offspring Control Blocks .. OCBs . are accessed 
via the TCB and field T.OCBH. 

Chaining down the list of OCBs is done by 

POD>examine 

POD>chain 

The TCB for the parent task is accessed via O.PTCB, 

POD>chain O.PTCB 
The EXEMC macro is PKTDF$. 
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IORB 

The IORB structure describes I/O Packets. IORBs are referenced, for 
example, from the SCB field S.PKT. The I/O parameters are displayed 
in both octal and decimal, for convenience. 

Chaining down the list of IORBs is done by 

POD>examine 
or 

POD>chain 

The TCB originating the I/O request can be accessed via I.TCB, 
POD>chaln I.TCB 

The UCB for the unit on which the request is queued can be accessed 
via I. UCB, 

POD>chain I. UCB 

The EXEMC macro is PKTDF$. 

Example : 

I/O Packet 
I.LNK - 000000 
Priority ■ 36. 
EFN - 0. 
TCB of requestor ■ 000020 
2nd LUN word - 123066 
UCB addr - 000001 
Function code - 121202 

IOSB VA, bias, offset » 121202 012773 140002 

AST addr » 123066 
reserved - 012774 

Parameters (octal) - 140072 000371 000000 000000 000010 000000 
Parameters (decimal) =» -16326. 249. 0. 0. 8. . 
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SRDB 

The SRDB structure describes Send/Receive Data Blocks. 

Chaining down the list of SRDBs is done by 

POD>examine 
or 

POD>chain 

The Sender's Terminal UCB can be accessed via SRUCB, 
POD>chain SRUCB 

Example : 

Send/Receive Data Block 
Link - 000000 
Sender Task Name - ...VNP 

Send Data - 030001 054374 103240 103240 000000 111242 000000 000000 
000000 107130 100000 022000 050000 
Sender's Terminal UCB « 030070 
UIC of Sender - 001 001 



SRRDB 

The SRRDB structure describes Send/Receive by Reference Data Blocks. 

Chaining down the list of SRRDBs is done by 

POD>examine 
or 

P0D>chain 

The TCB for Sender's Task is accessed via SRRTCB, 
P0D>chain SRRTCB 
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SCB 

The SCB structure describes Status Control Blocks. Successive SCBs may 
be examined by 

POD>examine 
or 

POD>chain 

but the user is expected to know when to stop. 
The I/O queue listhead can be accessed by S.LHD, 

POD>chain S.LHD 
The current I/O packet is referenced by S.PKT, 

POD>chain S.PKT 
The EXEMC macro is SCBDF$. 
Example : 

Status Control Block 
I/O queue - 000000 027624 
Device priority - 240 
Vector/4 » 014 

Timeout - current, initial * 0. 5. 

Controller * 000 
Status - 000 
CSR - 177560 

Current I/O packet » 000000 
Fork Block - 000000 

Fork PC, R5, R4 - 000000 000000 000000 
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TCB 

The TCB structure describes Task Control Blocks. The head of the 
list of installed tasks is at $TSKHD. 

POD>examine $TSKHD 
POD>examine/s true ture-TCB @ 

The head of the list of active tasks is at $ACTHD, and the pointer 
to the currently active task is in $TKTCB. 

Chaining down the list of tasks in the System Task Directory (ie. 
installed tasks) is done by 

POD>chain T.TCBL 

Chaining down the list of active tasks is via T.ACTL, 

POD>chain T.ACTL 

The TCB has a number of pointers to other data structures, each of 
which can be accessed by the CHAIN command in POD: 



CHAIN argument 


Structure 


T.CPCB 


Checkpoint PCB 


T.RCVL 


Receive Queue Listhead 


T. ASTL 


AST Queue Listhead 


T.UCB 


UCB for TI: 


T.LDV 


UCB for the task load device 


T.PCB 


PCB for the task 


T.RRFL 


Receive by Reference Queue 


T.OCBH 


OCB Queue Listhead 



The Attachment Descriptor blocks may be accessed using the 
pointer displayed, subtracting 6 from the address, as structure 
ADB. 

The EXEMC macro is TCBDF$. 
Example : 



Task Control Block 
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T.LNK - 000000 

Task Priority - 205. 

I/O Pending - 0. 

Checkpoint PCB * 000000 

Task Name - NTINIT 

Receive queue * 000000 111126 

AST queue - 000000 111132 



Local Event Flags - 
TI: UCB * 030070 
Task list thread - 
-EXE 
-CHKIFXD 
-PMDIPRV 



37777400001 



107020 



T.STAT - 
T.ST2 * 
T.ST3 =» 

Default Priority « 
LBN for task load - 
UCB for load device 
PCB for task - 
Max task size * 
Next task in ATL 



205. 
000 031 
030140 

110674 
000045 

107020 



011 



000000 
0. 

000045 

110666 
000000 



Specified AST list - 
Buffered 1/0 » 
Task size, blocks * 
Attachment descriptors 
Offset in partition - 
Send by reference count * 0. 
Receive by reference queue ■ 000000 
OCB queue - 000000 111212 
OCB count * 0. 
Event Flag mask » 000001 
Event Flag mask address * 111136 
Group Global use count - 000000 



110666 



111206 
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UCB 

The UCB structure describes Unit Control Blocks. UCBs are referenced 
from a number of places. 

The DCB corresponding to the UCB can be accessed via U.DCB, 

POD>chain U.DCB 
The Redirect UCB can be accessed via U.RED, 

POD>chain U.RED 
The SCB can be accessed via U.SCB, 

POD>chain U.SCB 

The TCB for the attached task (if .any) is accessed via U. ATT, 

POD>chain U.ATT 
The EXEMC macro is UCBDF$. 
Example : 

Unit Control Block 
DCB address - 027506 
Redirect UCB - 027552 
Control flags » 074 

U.CTL » UC.QUE!UC.PWF!UC.ATT!UC.KIL 
Unit status - 001 
U.STS-1 » 
Unit « 000 

Unit status extension » 000 
U.ST2-1 » 

Characteristics words » 000007 000010 
U.CW1 » DV.TTYlDV.CCLtDV.REC 
SCB pointer » 027624 
Attached task TCB » 000000 
Current I/O request - bias, offset, count » 



000000 000110 



000000 000000 040001 
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POD Data Structures for the Server Base Communications Executive 



The following data structures have been defined for the Server Base 
communications executive (DECnet-RSX/ 1 IS V4.0) 

For each data structure, its name, associated pointers, source 

macro name (from NETLIB.MLB) and list header or other access information 

is provided. 



DECHB 



The DECHB structure is used to display the DECnet Home Block* 
$DECPT points to the start of the DECnet Home Block. 

P0D>examine $DECPT 
POD>examine /s t ructure-dechb @ 

The remote node name list can be accessed via D$RNN, but first 
you have to bias into extended pool. 

P0D>bias $xbias 
POD>chain D$RNN 

The NETLIB macro is DHBDF$. 

Example : 

DECnet Home Block Format 
Alias Node Name Listhead ■ 000000 
Remote Node Name Listhead * 101074 
Pointer to End of Remote Node Name List ■ 004031 
Local Node Name * SBONE 
Local Node Number 

Area: = 4. 

Node Number: ■ 161. 
Local Node Identification » Server Base BL8 PhlV End Node 
Host Node Address 

Area: - 4. 

Node Number: ■ 19. 
Hi-order 4 bytes of Ethernet Address » $00AA $0004 
Number of Routing Channels * 2. 
DLL Service Database Address - 000000 
DLL Database FNB Address - 000000 
ECL Segment Size » 1466. 
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FEATR 



The FEATR structure is used to display the Feature 
Word for DECnet. It is the third characteristic 
word found in the UCB for NS:. (See the UCB 
description found in the Executive data structure 
section) • 

Once you've determined the address of the feature 
word, is the following command: 

POD>examine/ structure-f eatr x 

The NETLIB macro is NSFDF$. 

Example : 

Features Word for DECnet 
Event Logging Support 
Logical Link Integrity Support 
System is an End Node 
System Level Interface Support 



RNN 



The RNN structure describes the Remote Node Name List. 
The list can be accessed through the DECnet Home BLock 
via D$RNN, but you must be mapped into extended pool 
to chain throught the list. 

Chaining down the remote node name list is done by 

POD>examine 
or 

POD>chain 
The NETLIB macro is RNBDF$. 
Example : 

Remote Node Name List 
R.LNK - 004031 
Node Name * SBONE 
Address 

Area: » 4. 

Node Number: » 161. 
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PDV 



The PDV structure Is used to display the Process Descriptors, 
$PDVTA points to the process descriptor vector table, which 
contains the PDV addresses. 

You must determine the address you wish to examine before 
you can display a PDV. 



P0D>examine $PDVTA 
$PDVTA/ x 
POD>examlne x:x+20 



x/ a 

x+2/ b 

• • 

• s 

x+20/ c 



POD>examine/str*pdv a 

After examining the PDV for XPT you can chain to 
the XPT Database, viz: 

POD>chain xpt 

If you examine the PDV for ECL, you can chain to the 
ECL Database, viz: 

POD>chain ecldb 

Chaining to the associated PCB is also possible by 

POD>chain z.pcb 



The NETLIB macro is PDVDF$. 
Example : 

Process Descriptor 

Process » AUX 

Type - LLC 

Priority - 340 

Flags » 000614 

Z.FLG - ZF.MTM! ZF.TIM! ZF.MFL 

Process Relocation Bias - 014265 
Dispatch Table Address • 120000 
Free Space Pointer * 000000 
PCB Address - 074650 

LLC Data Base Virtual Address * 074244 
No. of Channels » 0. 



DATA STRUCTURE DEFINITIONS 



System Line Number 
Station Number » 
Channel * 
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ECLDB 



The ECLDB structure describes ECL's database. 
The database can be accessed through ECL's PDV 
via a chain operation specifying ECLDB* Or 
an examine can be done using the address 
specified as the "LLC Data Base Virtual 
Address" • 



From here you can chain to the mailbox queue or 
ECL's node counters. 

Issue the following command to chain to the 
mailbox queue. 

POD>chain n$mbxq 

To look at ECL's node counters, you must 
first set up mapping through APR 6, using 
the value displayed in ECL's database 
as "ECL Node Counters APR Bias". 

POD>map x 
POD>chain n$enc 

The NETLIB macro is ECDDB$. 

Example: 

ECL Data Base 
ACP CCB Queue Listhead - 000000 074054 
Timer Count » 0. 
Flags Byte • 040 
Flags - NF$M0U 
Function Code * 000002 
Dummy VCB - 000021 
Source Node Address 

Area: ■ 4. 

Node Number: * 10. 
Round Trip Delay ■ 10. 
Source Link Address - 024150 
Destination Link Address =- 044401 
Error Code = 000051 
Mapping of Current LLT » 014174 
Current LLT Virtual Address - 034230 
Current LLT Physical Address » 034230 
Current Active Logical Links =» 1. 
Current Maximum Logical Links » 2. 
Count of CI's Ignored Due to Resources * 0. 
Logical Link Table Length - 40. 
Logical Link Table Address » 030360 
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ECL Node Counters Listhead * 140050 140000 

ECL Node Counters APR Bias * 014170 

Mailbox Queue Listhead - 030220 

General Delivery CCB Queue Listhead - 000000 

General Delivery Current Timer * 4. 

General Delivery Initial Timer * 5. 
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ECLNC 



The ECLNC structure describes the ECL Node 

Counters. The node counters are accessed 

through ECL's database, a bias and address 

Is displayed which can be used for exmanlng 

the node counters or you can use a chain function 

described under ECLDB. Successive node counters 

may be examined by 

POD>examlne 
or 

POD>chaln 
The NETLIB macro Is CTRDF$ • 
Example : 

ECL Node Counters List 
E$NLNK - 140120 
Node Address 

Area: =» 4. 

Node Number: -10. 
Number of Active Logical Links ■ 1. 
Retransmit Period » 10. 
Message Start Time - 000000 

Segment Number of the Packet Being Timed * 0. 

Logical Link Address of Segment - 000000 

Number of Bytes Received » 156. 0. 

Number of Bytes Sent * 341. 0. 

Number of Messages Received ■ 66. 0. 

Number of Messages Sent * 66. 0. 

Number of Connects Received ■ 1. 

Number of Connects Sent - 0. 

Maximum Logical Links * 1. 

Number of Response Time-outs - 0. 

Number of Connects Ignored » 0. 

Time this Counter Block Last Zeroed * 001250 



NOTE 

The counters are displayed (32 bit 
decimal values) as <low 16 bits.>, <hlgh 
16 blts*>. The actual number is [<hlgh 
16 bits.> * 32767.] + <low 16 bits.>. 
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MBX 



The MBX structure describes Mailbox Queue. 
You can display successive entries by 
issuing the following: 

POD>examine 
or 

POD>chain 

Issue the following command to chain 
to the TCB for the associated task. 

POD>chain m.task 

The NETLIB macro is MBXDF$ • 

Example : 

Mailbox Queue 
M.NEXT - 000000 
Pointer to Task TCB « 106160 
Number of AST Entries * 0. 
Number of Active Logical Links - 1. 
Maximum Number of Logical Links * 1. 
User Network Data AST Address - 122342 
Network Data Listhead =• 000000 
Link Recovery Timer « 0. 
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LLT 

Logical Link Tables are pointed to off of 
the ECL Database. ECL's database displays 
both a "Current LLT Virtual and Physical 
Address" which can be used for examining 
the current LLT. It also contains a 
"Logical Link Table Address and Length", 
which can be examined to determine the 
addresses of all LLTs • 

Once you know the address you wish to 
examine, issue the following command: 

POD>examine/str~llt x 

Issue the following command to chain 
to the window block associated with 
this LLT, 

POD>chain l.wind 

The NETLIB macro is LLTDF$. 



Example : 

Logical Link Table Entry 
Link State ■ ST$DAT - Normal Data Transfer 
Link Type - 000 

Logical Link Addresses - Local, Remote - 046001 024031 
Remote Node 16 bit Address 

Area: » 4. 

Node Number: * 10. 
No. of Transmits in Progress - I/LS, Data ■ 0. 0. 

Link Flags ■ 200 
L .FLAG - LF.MMF 
Remote NSP Version » 0. 

Next Segment Numbers to be Assigned - Data, I/LS - 12. 17. 

Next Data Segment Number to be Received * 13. 
Highest Ack # From User on Data Channel * 12. 
Next I/LS Segment Number to be Received » 4. 
Highest I/LS Ack # from User » 3. 

Last Segment Numbers Ack'd - Data, INT/LS * 11. 16. 

User Disconnect Sub-state » US$D0N - Disconnect Complete 
Network Disconnect Sub-state ■ NS$D0N - Disconnect Complete 
Window Block = 033524 

Transmit Count, Interrupt Count ■ 0. 1. 

Flow Control Request Count (I/LS) - 0. 
Flow Control Request Count (Data) * 0. 
Remote Flow Control Count Estimate * 0. 
I/LS Pending ACK Queue - 000000 

Timer and Retry Cell (Data) = 0. 5. 
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Timer and Retry Cell (I/LS) ■ 0. 5. 

Message Awaiting Retransmission » 0. 

Long Term Timer * 0. 

Timer (seconds) * 0. 

Periodic Timer - 5. 

Initial Long Term Timer * 0. 

Message Re-assembly Queue * 000000 

Size of Re-assembly Queue - 0« 

Re-assembly Queue Timer - 0. 

Pointer to ECL Counter Block - 140050 

Segment Size for this Link * 561. 

Disconnect Reason Code (In Octal) - 000400 

Length of Optional Data (In Decimal) * 0. 

Optional Data (In Octal) * 001 000 000 001 000 001 000 

000 

Source Channel Number - 1. 
User Link Address - 000 
Control Process PDV - 000 
Data Process PDV * 000 

Transmit Message Queue Listhead * OOOOdO 034356 
Current Transmit CCB Address * 000000 

Interrupt Message Transmit Queue Listhead * 000000 034364 
Current Interrupt CCB Address - 000000 
Pending Control CCB Address - 000000 
Pending Accept CCB Address - 000000 
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WBBLK 



The WDBLK structure describes a Window Block. 
You must first examine a LLT to determine the 
window block address, it will be shown in 
octal as "Window BLock" in the output of an LLT, 



Issue the following command to chain 

to the LLT associated with this window block, 



POD>chain w.llt 



And if you wish to examine the associated 
mailbox, you can type 



POD>chain w.mbox 



The NETLIB macro is LLWDF$ • 



Example : 



Window Block 



Link Status - 000 
W.STAT * 



Task Lun ■ 2. 
Pointer to Associated LLT 
Segment Size * 561. 



034230 



Temporary Workspace » 
Pointer to Mailbox ■ 



000000 
030220 



Kernal AST Status = 000 
W.KAST - 
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XPT 



The XPT structure describes XPT's database. 
The database can be accessed through ECL's PDV 
via a chain operation specifying XPT • Or 
an examine can be done using the address 
specified as the "LLC Data Base Virtual 
Address" . 



From here you can chain to the NI Cache, 
Transport Line Counters, or Transport 
Node Counters. 

In all cases your region must have previously 
been set to NT. XPT. 



The commands are as follows: 



For NI Cache - . 



POD>chain niche 



To look at XPT's line counters, you must 
first set up mapping through APR 6, using 
the value displayed in XPT's database 
as "Transport Line Counter's Bias" - 



POD>map x 
POD>chain xlncou 

And for XPT's node counters - 



POD>chain xndcou 



The NETLIB macro is XPDDB$. 



Example : 



XPT Database 
TCB Address of Level 1 Router - 000000 
Level 1 Routing Message Listhead - 000000 
TCB Address of Level 2 Router - 000000 
Level 2 Routing Message Listhead - 000000 
Level 1 Routing Timer =* 0. 
Level 2 Routing Timer - 0. 
Physical Link Block Vector Size « 
Physical Link Block Vector Address ■ 
Reachability Vector Size » 0. 
Reachability Vector - Bias, Address - 
Area Reachability Vector Size =» 
Area Reachability Vector - Bias, Address 
Minhop/Mincos t Vector Size * 0. 



073516 



073524 



2. 

072414 

000000 
0. 

000000 



000000 



000000 
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Minhop/Mincost Vector - Bias, Address - 000000 000000 
Area Minhop/Mincost Vector Size - 0* 

Area Minhop/Mincost Vector - Bias, Address - 000000 000000 
Hops/Cost Matrix in RCP - Bias, Address * 000000 000000 
Area Hops/Cost Matrix In RCP - Bias, Address - 000000 000000 
NI Cache Size - 40. 
NI Cache Address * 130406 

Number of Password Database Entries - 0. 

Password Database Address » 073634 

Bias of Adjacency Database Part 1 - 120052 

Bias of Adjacency Database Part 2 - 120056 

Broadcast Router Priority Table Address * 030260 

Number of Transport Line Counter Blocks ■ 1. 

Transport Line Counter - Bias, Address * 014167 140000 

Trace Control Word - 000000 

Trace Collector TCB Address - 000000 

Trace Control Block Address - 000000 

Transport Node Counter Size - 4. 

Transport Node Counter Address * 127240 
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NICHE 



The NICHE structure displays NI Cache. 
The address to this location can be found 
by examining the XPT Database. You 
can also chain to it from this database. 
See XPT description for further details. 

To follow down the entries, you can issue 
either of the following commands: (Note: 
your region must have been set to NT. XPT) 



P0D>examine 
or 



POD>chain 



The NETLIB macro is CACDF$. 



Example : 



NI Cache 
Node ID of Destination 
Area: » 4. 
Node Number: - 



10. 

$AA 
60. 



Node Id of Next Hop ■ 
Lifetime Timer « 



$00 



$04 



$00 
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XPTNC 



The XPTNC structure displays the Transport 
node counters. 

The address to this location can be found 
by examining the XPT Database. You 
can also chain to it from this database. 
See XPT description for further details.' 



Once address has been determined, you 
can issue the command: 

POD>examine/str*xptnc x 



The NETLIB macro is CTRDF$ . 
Example : 

Transport Node Counters 
Message Format Error Counter - 
Verification Reject Counter ■ 
Node Unreachable Packet Loss Counter 
Aged Packet Loss Counter * 0. 
Node Out of Range Packet Loss Counter 
Oversized packet Loss Counter * 
Partial Routing Update Loss Counter * 



0. 
0. 



0. 



0. 
0. 

0. 
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XPTLC 



The XPTLC structure displays the Transport 
line counters. 

The address to this location can be found 
by examining the XPT Database. You must 
first set up a mapping value in APR 6, 
this is displayed as part of the XPT 
database also. 

You can also chain to it from the XPT 
database • 

See XPT description for further details. 



Once bias and address have been determined, 
you can issue the commands: 

POD>map z 

POD>examine/ s t.r»xptlc x 

Chaining down the XPT line counters is done by 

POD>examine 
or 

POD>chain 



The NETLIB macro is CTRDF$. 
Example : 

Transport Line Counters 
System Line Number Station Number * 000 000 
Output Packets Received Counter « 1058. 
Input Packets Sent Counter * 1068. 0. 

Line Down Count * 0. 
Line Initialization Failure * 0. 
Transit Packets Received Counter - 0. 
Transit Packets Sent Counter * 0. 
Transit Congestion Loss Count • 0. 
Time Since Counters Last Zeroed * 0. 
Initial Hello Timer - 15. 
Initial Listener Timer * 30. 

SVC Descriptor - Bias, Address - 000000 000000 
Routing Priority for Circuit » 64. 
Number of Routers per NI » 10. 
DLM Flags - 000 
Corruption Loss = 000 



042 
0. 



0. 



004 



0. 
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NOTE 

The counters are displayed (32 bit 
decimal values) as <low 16 bits.>, <high 
16 bits.>. The actual number is [<high 
16 bits.> * 32767.] + <low 16 bits.>. 
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SLT 



The SLT structure Is used to display the System Line Table. 
$SLTMA points to the system line table, which 
contains the addresses of the SLTs • 

You must determine the address you wish to examine before 
you can display a SLT. 



POD>examine $ SLTMA 
$SLTMA/ x 
POD>examine x:x+20 
x/ a 
x+2/ b 



x+20/ c 
POD>examine/ str»slt a 



The NETLIB macro is SLTDP$. 
Example : 

System Line Table 
Flags Word - 142410 
Buffer Wait Queue Count » 

L.FLG - LF . ACT! LF .RDY! LF .ENA! LF . BRO ! LF . TIM 

DDM PDV Index - 020 

DDM Line Table Address » 130532 

DLC PDV Index » 014 

DLC Line Table Bias - 015054 

DLC Line Table Virtual Address - 125750 

Line Owner ■ 000 

Controller No. » 000 

Unit No. - 000 

No. of Stations » 005 

Cost ■ 1. 

State - On 

Sub-State - Closed 
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EPMLT 



The EPMLT structure describes the EPM Line Table* 
To access this your region must be set to NT. EPM. 
You must find the appropriate SLT entry for EPM 
because this structure contains the address of the 
EPM Line Table. If you look through the SLT entries 
you will find a "DLC PDV Index". This value can be 
used as an offset into the PDV vector. 
If you examine the address at this offset as a 
PDV structure, you will be able to tell by the 
Process Name whehter the SLT entry is for EPM. 
When you have the correct SLT entry, EPM will 
show up as the Process Name in the corresponding 
PDV. 

Once you've determined that you are looking at 
the correct SLT, use the "DLC Line Table Bias" 
as mapping through APR 6 and examine the 
"DLC Line Table Virtual Address" as the 
address to EPM's Line Table. 

POD>examine/structure*EPMLT x 

The NETLIB macro is EPMDF$. 

Example: 



EPM Line Table 
Current Timer * 1. 
Initial Timer * 1. 
System Line Number * 
Controller Flags ■ 014 
C$FLG - CF$CHN! CF$SID 
Active Ports - 1: » 
Started Ports - 1: ■ 
Local Workspace ■ 000000 



0. 



0. 
0. 



000034 



$0004 



$10A1 



Destination Address From Last Received Message ■ $00AA 
Source Address From Last Received Message » $00AA $0004 $1011 

Protocol from Last Message =» 001540 
Pending Control Function Queue Listhead * 000000 
Active Control Function « 000000 

Pending Network Management Function Queue * 000000 126006 
DDM PDV Index - 000 

Timer Cell for System ID Message » 0. 
Timer Refresh Value ■ 0. 

Device Hardware Address * $00AA $0004 $10A1 

Line Table Extension for Network Management - 000000 000000 125150 

Data Overrun Counter - 0. 

Unrecognized Frame Destination Counter - 4983. 
Port Table Listhead = 126052 126242 
Protocol Table Listhead - 125700 125700 
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EPMPT 



The EPMPT structure describes the EPM Port Tables. 
To access this structure, your region must be set 
to NT. EPM. The address for the Port Tables, can 
be found by examining the EPM Line Table* The 
address is referenced by "Port Table Listhead" 
You use the first address specified to examine 
the first entry in the port table. 

POD>examine/s tructure-EPMPT x 

Chaining down the port table is done by 



POD>examine 
or 

POD>chain 
The NETLIB macro is EPMDF$ • 



Example : 

EPM Port Table 
System Line Number * 0. 
Station Number =» 0. 
Port Flags - 200 
Port is Active 

Multicast Address Chain Listhead - 125714 125714 

Seconds Since Last Zeroed * 0. 

Data Blocks Received = 2175* 0. 

Bytes Received - 29750. 1. 

Data Blocks Sent =» 2183. 0. 

Bytes Sent * 5828. 1. 

User Buffer Unavailable * 0. 



NOTE 

The counters are displayed (32 bit 
decimal values) as <low 16 bits.>, <high 
16 bits.>. The actual number is [<high 
16 bits.> * 32767.] + <low 16 bits.>. 
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EPMPRT 



The EPMPRT structure describes the EPM Protocol 
Table. To access this structure, your region must 
be set to NT. EPM. The address for the Protocol 
Table, can be found by examining the EPM Line Table. 
The address Is referenced by "Protocol Table Listhead" 
You use the first address specified to examine 
the first entry in the protocol table. 

POD>examine/st ructure-EPMPRT x 

Chaining down the protocol table is done by 

POD>examine 
or 

POD>chain 
The NETLIB macro is EPMDF$. 
Example : 



EPM Protocol Table 
Protocol flags * 005 
L$FLG - LF$PAD ! LF$EXC 
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PLB 



The PLB structure describes the Pysical 
Link Block. The XPT database contains 
an address, "Physical Link Block Vector 
Address", which points you to a vector 
of PLB addresses. Use the first address 
in this vector to start examining PLBs • 

POD>examine/ s t ructure-PLB x 

Chaining down the physical link block 
is done by 

POD>examine 
or 

POD>chain 
The NETLIB macro. is PLBDF$. 
Example : 

Physical Link Block 
Link State - PS$UP - Up 
Adjacent Node Type - 201 

Broadcast Channel 

Level 2 Routing Node 
Link Recovery Flag * 

Count of Outstanding Control Requests » 0. 
Recovery Timer ■ 0. 
XPT Channel Number ■ 1. 
Number of Messages Queued * 0. 
Pending Control function Queue - 000000 
General Protocol Timer * 13. 
Flags - 000005 

Link has been Enabled 
Desired Link State: » Up 
Input Packet Limit * 0. 
Designated Router Countdown Timer =■ 0. 
Maximum Delay for Routing Message Level 1 - 0. 
Maximum Delay for Routing Message Level 2 ■ 0. 
Level 1 State - 000 
Level 2 State » 000 
Transport Block Size ■ 576. 

Count of Adjacent Nodes of Low TSIZ = 1. 

Store and Forward Queue Listhead - 000000 072522 

Transport Counter Block Address * 140000 

16 Bit Address of Designated Router - 010176 

Number of Routers on NI = 10. 

Circuit Routing Priority = 64. 
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PAMLTB 



The PAMLTB structure describes the PAM Line Table. 
To access, set region to NT, PAM. You must find the 
appropriate SLT entry for PAM because this structure 
contains the address of the PAM Line Table* 
From the SLT entry, use the "DDM Line Table Address" 
as the address to examine. 



POD>examine /s tructure-PAMLTB x 



The NETLIB macro is PMTDF$ . 
Example : 



PAM Line Table 



General timer: current, reset value - 000 002 

Hotswap timer: current, reset value - 0.00 0$6 

Transmit timer: current, reset value ■ 000 012 

Physical unit number » 000 

System line number * 001 

Pending control CCB address ■ 000000 

Controller table address * 136274 

Cursor position and page count * 000 000 000 

Line powerfailed or never enabled 



Receive Segment Descriptor Block Controls 

Descriptor block starting address * 000000 
Descriptor block ending address * 000000 
Address of next descriptor to complete * 000000 

Transmit Segment Descriptor Block Controls 

Descriptor block starting address * 000000 
Descriptor block ending address ■ 000000 
Address of next descriptor to build - 000000 
Address of next descriptor to complete - 000000 
Transmit CCB listhead » 000000 136564 



Line Characteristics 



Line card type ■ ** 000000 ** 
Line protocol - DDCMP 

Asynchronous line transmit speed * 19200 baud 
Asynchronous line receive speed ■ 19200 baud 
Synchronous line speed ■ ** 000037 ** 
Character length » 8 bits 
Station number « 000001 
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If ASYNC protocol, two stop bits used 
Line card synchronous clock enabled 
AST dispatches to DLC enabled 
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PAMCTB 



The PAMCTB structure describes the PAM Controller 
Table. To access, set region to NT. PAM. Use the 
"Controller Table Address" In the PAm Line 
Table as the address to examin . 

POD>examine/s t ructure-PAMCTB x 

The NETLIB macro is PMTDF$. 

Example : 



PAM Controller Table 

Controller number =» 000 
First CSR address - 171300 
Second CSR address - 171302 
Status interrupt priority mask * 000100 
Error interrupt priority mask * 000100 
Network pool allocation bias - 014124 
Network pool allocation address * 140000 
Controller powerfailed or uninitialized 

Command Descriptor Block Access Controls 

Number of descriptors in block » 000004 
Descriptor block starting address * 000000 
Descriptor block ending address * 000000 
Address of next descriptor =» 000000 

Status Descriptor Block Access Controls 

Number of descriptors in block » 000020 
Descriptor block starting address * 000000 
Descriptor block ending address ■ 000000 
Address of next descriptor » 000000 

Small Free Segment Descriptor Block Access Controls 

Number of descriptors in block - 000020 
Descriptor block starting address » 000000 
Descriptor block ending address ■ 000000 
Address of next descriptor » 000000 

Large Free Segment Descriptor Block Controls 

Number of descriptors in block » 000020 
Descriptor block starting address « 000000 
Descriptor block ending address * 000000 
Address of next descriptor ■ 000000 
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Buffering and Interrupt Timer Controls 

Number of available lines =■ 000 

Number of lines enabled ■ 000 

Minimum receive buffering level * 002 

Maximum receive buffering level * 004 

Current receive buffering level * 000 

Maximum transmit buffering level - 012 

Next line to post buffer request on * 017 

RDBs : number required - 000 

RDBs : number allocated * 000 

SDBs : number required - 000 

SDBs : number allocated ■ 000 

Receive CCB listhead * 000000 136466 



LAT protocol timer « 000 
CTERM protocol timer - 017 
Line card status timer * 377 
Driver process index ■» 000000 

Line Table Address List 



Line 


table 





address » 


000000 


Line 


table 


1 


address » 


000000 


Line 


table 


2 


address - 


000000 


Line 


table 


3 


address * 


000000 


Line 


table 


4 


address ■ 


000000 


Line 


table 


5 


address « 


000000 


Line 


table 


6 


address « 


000000 


Line 


table 


7 


address =■ 


000000 


Line 


table 


8 


address « 


000000 


Line 


table 


9 


address » 


000000 


Line 


table 


10 


address » 


000000 


Line 


table 


11 


address =» 


000000 


Line 


table 


12 


address ■ 


000000 


Line 


table 


13 


address - 


000000 


Line 


table 


14 


address * 


000000 


Line 


table 


15 


address « 


000000 



Default ASYNC Protocol Parameters 

Line width « 120 

Page length » 030 

Stop length » 030 

Carriage return fill count = 000 

Line feed fill count * 000 

Transmit work mask zero * 377 

Transmit work mask one =» 377 

X0N character - 021 

X0FF character - 023 

Receive work mask » 375 



Default DDCMP Protocol Parameters 
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Select timer value - Oil 
Reply timer value - Oil 
Number of SYNC characters - 010 
Number of PAD characters * 007 
Maximum abutted messages « 002 

Default SDLC Protocol Parameters 



Number of trailing FILL characters - 



002 
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APCLTB 



The APCLTB structure describes the APC Line Table. 
To access, set region to NT. APC. You must find the 
appropriate SLT entry for the PAM because this structure 
contains the address of the APC Line Table* 
From the SLT entry, use the "DLC Line Table 
Virtual Address" as the address to examine. 

POD>examine/s tructure-APCLTB x 

Example : 
APC Line Table 

Process timer: current, reset * 000 000 
Address of pending enable/disable CCB ■ 000000 
Address of pending start/stop CCB » 000000 
Number of pending transmits ■ ' 000000 
System line number - 001 
Line protocol - ASYNC 
Line state * Halted 

Network management listhead - 000000 123670 

Time since counters zeroed (unformatted): line * 000000 

Time since counters zeroed (unformatted): circuit * 000000 



NOTE 

There is 1 other data structures which 
has not been documented. This will be 
made available at a later date. 

CIBLK - Describes the Connect 

Initiate Block 



If you wish to examine 
reference your Commun 
Documentation • 



this structure, 
ications Executive 



APPENDIX B 
SAMPLE SESSIONS 



$ ! 

$ ! 

$ ! Command File To Show Current Settings 

$ ! (Used in following two sample sessions.) 

$ ! 
$ ! 

$ TYPE SH0W.COM 
SHOW SERVER 
SHOW IMAGE 
SHOW REGION 
SHOW TYPE 
SHOW LENGTH 
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Example Of Using Pod To Look At A Distribution Image 



$! 
$! 
$! 
$! 

$ RUN POD 

Pluto On-Line Debugger - V3.0.0 
POD>SET SERVER BASE 
POD>SET IMAGE DIST-SBBL51 



ServerBaseBL5.0 Phase IV Endnode 
POD>SET REGION EXECUTIVE 
P0DX3SH0W 
P0D> 

Current server Is Server Base 

Symbol library file Is PODSB.SYM 

Executive symbol table contains 908 symbols 

P0D> 

Current image is server distribution SBBL51.SYS 

Access : Examine 

P0D> 

Current region is EXECUTIVE 
P0D> 



Default type setting(s) 
P0D> 

Default length setting: 

P0D> 

P0D> 

P0D>EXA $TKPS 



OCTAL 
WORD 



5726/ 74 
POD>EXA/DEC $TKPS 



5726/ 60. 
P0D>SET TYPE HEX,0CT,DEC 
P0D>SH0 TYP 

Default type setting(s): 
P0D>EXA $TKPS 



DECIMAL 



HEXADECIMAL 



OCTAL 



5726/ 60. 
P0D>SET TYPE OCTAL 
P0D>EXA 0: 10 



$ 3C 



74 



0/ 
2/ 
4/ 
6/ 
10/ 
P0D>EXIT 



1614 
4625 

15564 
340 

15460 
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$ ! 
$ ! 

$ ! Example Of Examining A Dump File 

$ ! 
$ • 

$ RUN POD 

Pluto On-Line Debugger - V3.0.0 
POD>SET SERVER X25 
POD>SET IM DU-EOMER1 

X25 6ateway( Router ) 
POD>SET REG SBI. 
POD>SET LEN BYTE 
PODX3SHOW 
POD> 

Current server is PSI Gateway 

Symbol library file is PODX25.SYM 

Executive symbol table contains 908 symbols 

P0D> 

Current image is crash dump file E0MER1.CDA 

Access: Examine 

P0D> 

Current region is SBI... 

Virtual address base is 120000 

Region symbol table contains 311 symbols 

P0D> 

Default type setting(s): OCTAL 
P0D> 

Default length setting: BYTE 

P0D> 

P0D> 

P0D>SH0 SYM SYSPAS 
Value is 120722 
P0D>E/0/A SYSPAS :SYSPAS+4 



120722/ 


4 




120723/ 


120 


'P 


120724/ 


122 


'R 


120725/ 


111 


'I 


120726/ 


126 


'V 


P0D>EXA 


BKPHST 





120644/ 5 

P0D>EXA/AS BKPHST+1 :BKPHST+5 



120645/ 'S 
120646/ 'M 
120647/ 'A 
120650/ 'U 
120651/ 'G 
P0D>SH0 SYM $EXSIZ 
Value is 5462 
P0D>EXA/W0RD $EXSIZ 
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POD>*Z 
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$ ! 
$ ! 
$ 
$ 
$ 
$ 
$ 

$ RUN POD 

Pluto On-Line Debugger 
POD>sho log 
Current log file Is: 
POD>sho output 
Current output Is: 
POD>set ser router 
POD>set lmag/dep/unp nod-eomer 



Example Of Using Pod To Examine And Deposit Into 
A Running Server Image 



- V3.0.0 



EXAM. LOG 
TERMINAL LOGGING 



DECnet Router Server VI .0 
P0D>set reg executive 
P0D>! 
P0D> ! 

P0D>! Examine PCB structure 
P0D>! 

P0D>exa $parhd 

$PARHD / 111734 

POD>ex/st«pcb @ 



Partition Control Block 

P.LNK - 111670 

Priority - 0. 

10 + IOSB count « 0. 

Partition Name - CEXPAR 

P. SUB * 000000 

P. MAIN - 111734 

P.REL - 001120 

P. SIZE - 000060 

Wait Queue * 000000 

Swap Size - 111754 

Busy Flags - 200 200 

P.TCB - 000000 

Starting APR » 

Common 

P0D> ! 

P0D>! Chain to next pcb 

P0D> ! 

P0D>ch 



Partition Control Block 

P.LNK - 111624 

Priority » 0. 

10 + IOSB count * 0. 

Partition Name - NTP00L 

P. SUB - 057524 

P. MAIN - 111670 
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P.REL - 001200 

P. SIZE * 003740 

Wait Queue - 000000 

Swap Size - 111710 

Busy Flags ■ 200 200 

P.TCB » 000000 

Starting APR * 

System controlled 

P0D>! 

P0D>! Chain down the sub-partition 
P0D>! 

P0D>ch p. sub 



Partition Control Block 

P.LNK - 000000 

Priority - 0. 

10 + IOSB count ■ 0. 

Partition Name * SBP00L 

P. SUB - 000000 

P. MAIN » 111670 

P.REL * 001200 

P. SIZE - 003703 

Wait Queue =■ 000000 

Swap Size * 000000 

Busy Flags « 000 000 

P.TCB - 000000 

Starting APR - 

Not shuffleable 

Common 

System controlled 

P0D> ! 

P0D>! 

P0D> ! Redisplay this data in another output format 

P0D> ! 

P0D>disp/oct /dec/by 



57524 


/ 


0. 





57525 


/ 


0. 





57526 


/ 


0. 





57527 


/ 


0. 





57530 


/ 


32. 


40 


57531 


/ 


119. 


167 


57532 


/ 


36. 


44 


57533 


/ 


96. 


140 


57534 


/ 


0. 





57535 


/ 


0. 





57536 


/ 


184. 


270 


57537 


/ 


147. 


223 


57540 


/ 


128. 


200 


57541 


/ 


2. 


2 


57542 


/ 


195. 


303 


57543 


/ 


7. 


7 


57544 


/ 


0. 





57545 


/ 


0. 
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57546 
57547 
57550 
57551 
57552 
57553 
57554 
57555 



0. 
0. 
0. 
0. 
0. 
0. 












160. 
1. 



240 
1 



P0D>! 

POD>! Show structures which can be displayed 
POD>! 

P0D>SH0 STRUCT 



Data Structures 

DECHB 

FEATR 

ECLDB 

MBX . 

WD BLR 

XPT 

NICHE 

RNN 

ECLNC 

XPTNC 

XPTLC 

PLB 

CIBLK 

PDV 

SLT 

LLT 

EPMLT 

EPMPT 

EPMPRT 

ETHADD 

ETHADD 

CRASH 

CLKQ 

DCB 

TSKHDR 

HDRWND 

ADB 

PCB 

AST 

OCB 

IORB 

SRDB 

SRRDB 

SCB 

TCB 

UCB 



POD>EXA $DECPT 
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$DECPT / 102200 

P0D>! 

P0D>! 

P0D>! Examine DECnet Home Block Structure 
P0D>! 

POD>E/ST«DECHB <? 

DECnet Home Block Format 
Alias Node Name Listhead * 000000 
Remote Node Name Listhead - 102204 
Pointer to End of Remote Node Name List * 030235 
Local Node Name - E0MER 
Local Node Number 

Area: » 4* 

Node Number: * 126 • 
Local Node Identification » DECnet Router Server VI .0 
Host Node Address 

Area: ■ 4. 

Node Number: "19. 
Hi-order 4 bytes of Ethernet Address - $00AA $0004 
Number of Routing Channels * -10. 
DLL Service Database Address ■ 000000 
DLL Database FNB Address - 000000 
ECL Segment Size * 558. 
P0D>! 
P0D>! 

P0D>! Must set up bias into extended pool, so that can chain through 

P0D> ! remote node name list 

P0D>! 

P0D>BIAS $XBIAS 
P0D>CH D$RNN 

Remote Node Name List 
R.LNK » 030235 
Node Name =» E0MER 
Address 

Area: * 4. 

Node Number: - 126. 
P0D>CH 

Remote Node Name List 
R.LNK - 030221 
Node Name - VORTEX 
Address 

Area: ■ 2. 

Node Number: * 1, 
P0D>CH 

Remote Node Name List 
R.LNK » 030205 
Node Name = ECHO 
Address 

Area: = 2. 
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Node Number: * 2. 
POD>CH 

Remote Node Name List 
R.LNK - 030171 
Node Name « JEDI 
Address 

Area: - 2. 

Node Number: * 3. 

P0D> ! 
P0D>! 

P0D>! Cancel Bias Operation 
P0D>! 

P0D>N0BIAS 
P0D> 
P0D>! 
P0D>! 

P0D>! Put a patch in to count the number of times the routine 
P0D> ! $LDBRT is entered. (There is a patch area in the Server Base 
P0D>! starting, at location $PATCH) 
P0D>! 

P0D>E $LDBRT:$LDBRT+6 

$LDBRT / 10246 

$LDBRT + 2/ 10346 
$LDBRT + 4/ 10546 
$LDBRT + 6/ 13746 
P0D>EXA $PATCH:$PATCH+20 



$PATCH 




/ 





$PATCH 


+ 


2/ 





$PATCH 


+ 


4/ 





$PATCH 


+ 


6/ 





$PATCH 


+ 


10/ 





$PATCH 


+ 


12/ 





$PATCH 


+ 


14/ 





$PATCH 


+ 


16/ 





$PATCH 


+ 


20/ 






P0D> ! 

POD>! Set address display to octal, so can use octal 
P0D> ! address values when depositing patch 



P0D> ! 




P0D>SET 


ADDRESS OCTAL 


P0D>EXA 


$LDBRT: $LDBRT+6 


112170/ 


10246 


112172/ 


10346 


112174/ 


10546 


112176/ 


13746 


P0D>EXA 


$PATCH:$PATCH+20 


752/ 





754/ 





756/ 
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760/ 

762/ 

764/ 

766/ 

770/ 

772/ 



P0D>DEP $PATCH«5227,0, 10246, 10346, 137 , 1 12174 
P0D>EXA $ PATCH :$PATCH+6 



752/ 5227 

754/ 

756/ 10246 

760/ 10346 



P0D>EXA $PATCH:$PATCH+12 



752/ 
754/ 
756/ 
760/ 
762/ 



10246 
10346 



5227 




137 



764/ 112174 
P0D> ! 
POD>! 

POO> ! You must examine a location performing attempting deposit 

P0D>! An error message will occur if you don't 

P0D>! 

P0D>DEP $LDBRT-137,752 
?Must Examine Before Deposit 
P0D>EXA $LDBRT:$LDBRT+6 

112170/ 10246 
112172/ 10346 
112174/ 10546 
112176/ 13746 
P0D>DEP $LDBRT>137,752 
P0D> ! 
P0D>! 

P0D>! Now monitor the location which is counting the number of times 

P0D> ! the routine is entered. 

P0D>! 

P0D>DEP/UNP $PATCH+2*0 
POD>MONITOR/TIM-100/INT-5 $PATCH+2 
Monitor started at 21-Mar-1984 14:13:12 



754/ 1106 

. . • in progress . . • 

754/ 1703 

754/ 2337 

754/ 3015 

754/ 3510 

754/ 4247 
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754/ 4721 

754/ 5424 

754/ 6003 

754/ 6651 

754/ 7540 

754/ 10222 

754/ 10653 

754/ 11420 

Monitor finished at 21-Mar-1984 14:14:19 

POD> ! 

P0D>! Reset the counter location, because it is constantly changing 
P0D>1 the only way to do this is by using the /UNPRO switch on 
P0D>! the DEPOSIT command. 
P0D>! 

P0D>DEP $PATCH+2 -0 
?Previous Contents Don't Match 
P0D>DEP/UNP $PATCH+2-0 
P0D>EXA $PATCH+2 

754/ 255 
P0D>! 
P0D>! 

P0D> ! Use the BIAS operation to look at object list in extended pool 
P0D> ! 

P0D>BIAS $XBIAS 
P0D>EX $OBJHD 

115676/ 31565 
POD>SET TYP RAD, OCT 
P0D>EXA 31565:31575 

1642564/ 31551 
1642566/ 1000 
1642570/ 
1642572/ 
1642574/ 
P0D>EX 31551:31561 

1642550/ 31535 
1642552/ 1023 
1642554/ 
1642556/ 54353 
1642560/ 131574 
P0D>EX 31535:31545 

1642534/ 

1642536/ 1031 

1642540/ 

1642542/ 51272 

1642544/ 131574 
P0D>N0BIAS 
P0D> ! 

P0D>! Without BIAS set the examine would fail 



HIA 
L2 



HH 
MK 

NIC 



MQ 
MIR 
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POD>! 

POD>EX 31535:31545 

?Invalid Odd Address Specified 

POD>! 

POD>! You could set region to physical and look at same locations 
POD>! 

POD>SET REG PHYSICAL 
POD>SHO REG 

Current region is PHYSICAL 
POD>EXA 1642534:1642544 

1642534/ 

1642536/ 1031 MQ 

1642540/ 

1642542/ 51272 MIR 

1642544/ 131574 
P0D>SET REG EXECUTIVE 
P0D> 
P0D> 

P0D>! Next example uses the MAP function to 'look at ECL's node 
P0D>! counters off of the ECL data base • To find ECL's data 
P0D>! base must find its PDV (process descriptor first) 

P0D>! 

P0D>E $PDVTA 



115470/ 117100 YL2 
P0D>SET TYP OCTAL 
P0D>EX $PDVTA 

115470/ 117100 
P0D>EX 117100:117120 



117100/ 


117474 


117102/ 


117514 


117104/ 


117534 


117106/ 


117554 


117110/ 


117620 


117112/ 


117674 


117114/ 


117712 


117116/ 


117730 


117120/ 


117746 


P0D>ex/st 


»pdv 117534 



Process Descriptor 

Process =« ECL 

Type - LLC 

Priority - 340 

Flags = 001214 

Z.FLG - ZF.COU! ZF.TIM! ZF.MFL 

Process Relocation Bias - 016533 
Dispatch Table Address » 123644 
Free Space Pointer » 000000 
PCB Address = 056744 

LLC Data Base Virtual Address =» 056664 
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No. of Channels - 0. 
System Line Number ■ 
Station Number - 35 
Channel =■ 
P0D>CH ECLDB 



304 



000000 



ECL Data Base 
ACP CCB Queue Listhead * 
Timer Count «■ 0. 
Flags Byte - 040 
Flags - NF$M0U 
Function Code - 000002 
Dummy VCB - 005622 
Source Node Address 

Area: - 4. 

Node Number: * 10 
Round Trip Delay - 
Source Link Address * 
Destination Link Address 
Error Code - 000051 
Mapping of Current LLT - 016301 
Current LLT Virtual Address - 140054 
Current LLT Physical Address - 017155 
Current Active Logical Links - 1* 
Current Maximum Logical Links - 20 
Count of CI's Ignored Due to Resources ■ 



056664 



4. 

012130 

107401 



20. 

030374 
140120 
016100 
030220 



48. 



140000 



Logical Link Table Length 
Logical Link Table Address 
ECL Node Counters Listhead 
ECL Node Counters APR Bias 
Mailbox Queue Listhead =» 
General Delivery CCB Queue Listhead « 000000 
General Delivery Current Timer » 4. 
General Delivery Initial Timer ■ 5. 
P0D> ! 

P0D>! Map through APR 6 to get to node counters 
P0D>! Using ECL Node Counters APR Bias above 
P0D>! 

P0D>MAP 16100 
P0D>CH N$ENC 



ECL Node Counters List 
E$NLNK - 140360 
Node Address 

Area: ■ 4. 

Node Number: » 24. 
Number of Active Logical Links * 0. 
Retransmit Period » 4. 
Message Start Time = 177777 
Segment Number of the Packet Being Timed * 
Logical Link Address of Segment » 000000 
Number of Bytes Received = 135. 
Number of Bytes Sent - 2491. 

Number of Messages Received » 236. 



3. 



0. 



0. 
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Number of Messages Sent * 243* 0. 

Number of Connects Received * 20. 

Number of Connects Sent * 0. 

Maximum Logical Links » 1. 

Number of Response Time-outs » 0* 

Number of Connects Ignored ■ 0. 

Time this Counter Block Last Zeroed * 002156 

P0D>N0MAP 

P0D> 

P0D>! 

P0D> ! Demonstrate HELP command 

P0D> ! 

P0D>HELP 



POD, (PLUTO On-Line Debugger) 



The following is a list 

* <? 

* BIAS 

* BREAK 

* CONVERT 

* DEFINE 

* DEPOSIT 

* DISPLAY 

* EXAMINE 

* EXIT 

* HELP 

* MAP 

* MONITOR 

* NOBIAS 

* NOMAP 

* SET ADDRESS 

* SET IMAGE 



of available commands : 

* SET LENGTH 

* SET LOG 

* SET OUTPUT 

* SET REGION 

* SET SERVER 

* SET TYPE 

* SHOW IMAGE 

* SHOW LENGTH 

* SHOW LOG 

* SHOW OUTPUT 

* SHOW REGION 

* SHOW SERVER 

* SHOW STRUCTURE 

* SHOW SYMBOL 

* SHOW TYPE 

* UNDEFINE 



POD>! 
POD> ! 

P0D>! Demonstrate SHO SYMBOL command 
P0D> ! 

POD>SHO SYM T.* 



Symbol 


Value 


Symbol Table 


T.ACTL 


000052 


SYSTEM 


T.ASTL 


000016 


SYSTEM 


T.ATT 


000062 


SYSTEM 


T.CPCB 


000004 


SYSTEM 


T.DPRI 


000040 


SYSTEM 


T.EFLG 


000022 


SYSTEM 


T.EFLM 


000104 


SYSTEM 


T .EXT 


000000 


SYSTEM 
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T.GGF 

T.HDLN 

T.IOC 

T.LBN 

T.LDV 

T.LGTH 

T.L.NK 

T.MXSZ 

T.NAM 

T.OCBH 

T.OFF 

T.PCB 

T.PRI 

T.RCVL 

T.RDCT 

T.RRFL 

T.SAST 

T.SRCT 

T.STAT 

T.ST2 

T.ST3 

T.TCBL 

T.TIO 

T.TKSZ 

T.UCB 



000110 
000110 
000003 
000041 
000044 
000112 
000000 
000050 
000006 
000076 
000066 
000046 
000002 
000012 
000102 
000072 
000054 
000071 
000032 
000034 
000036 
000030 
000057 
000060 
000026 



SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 



POD>EXIT 



